Skip to content

Zodiac Sign Shadow¶

The Zodiac Sign Shadow endpoint provides static sign-level shadow-pattern and healing-focus meanings derived from zodiac sign.

This /horoscope/sign/* endpoint returns descriptive zodiac sign meanings (sign archetype data), not live astrological reports. For live astrological readings, use /api/v1/horoscope/reports/* report endpoints powered by our SOTA horoscope engine. The lightweight open-source engine is OpAstro.

Endpoint¶

Method	Path
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/sign/shadow`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/sign/shadow`

Request Parameters¶

GET Query¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

POST Body¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

Optional query parameter: lang=en|es|de|fr|pt.

Request Body¶

Name	Required	Type	Example	Description
`dob`	Yes	string	`1992-07-16`	Date of birth in `YYYY-MM-DD` format.

Example Requests¶

GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/sign/shadow?dob=1992-07-16&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/sign/shadow?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16"
}'

Example Response¶

{
  "zodiac_sign": "Cancer",
  "sign_shadow": {
    "sign_name": "Cancer",
    "sign_symbol": "♋",
    "dates": "June 21 – July 22",
    "element": "Water",
    "modality": "Cardinal",
    "ruling_planet": "Moon",
    "exalted_planet": "Jupiter",
    "detriment_planet": "Mars",
    "fallen_planet": "Saturn",
    "polarity": "Negative (Yin)",
    "shadow_archetype": "The Devouring Mother / Wounded Child",
    "core_shadow_pattern": "Emotional manipulation, clinging, using vulnerability as control, building walls when hurt.",
    "karmic_shadow_wound": "Past-life abandonment or enmeshment; terror of being left or engulfed.",
    "shadow_triggers": "Rejection, independence in others, feeling unsafe, criticism of caretaking role.",
    "shadow_work_practices": "Inner-child re-parenting, boundary exercises, anger release (non-harmful), forgiveness rituals toward family.",
    "integration_gift": "Healthy nurturing that empowers; profound emotional safety for self and others.",
    "affirmation": "I am safe within myself. My love flows freely without possession.",
    "spiritual_shadow_lesson": "The shell that protects too tightly becomes a tomb—true safety is vulnerability met with self-trust.",
    "sign_number": 4
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "558b1eb0280e9393",
    "quota": "unlimited",
    "usage_tracking": false
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.0",
    "endpoint_name": "horoscope_sign_shadow",
    "endpoint_description": "Provides shadow aspects for a zodiac sign.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-04-08T13:52:15.700185+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Response Notes¶

Returns zodiac_sign plus sign_shadow descriptive content.
Appends _enterprise and _api_metadata_.
This endpoint is deterministic sign-meaning content, not time-windowed transit output.