Skip to content

Zodiac Sign Personality¶

The Zodiac Sign Personality endpoint provides static sign-level personality, element, and archetype 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/personality`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/sign/personality`

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/personality?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/personality?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_motto": "I Feel",
  "sign_facts": {
    "element": "Water",
    "modality": "Cardinal",
    "ruling_planet": "Moon",
    "exalted_planet": "Jupiter",
    "detriment_planet": "Mars",
    "fallen_planet": "Saturn",
    "dates": "June 21 – July 22",
    "polarity": "Negative (Yin)",
    "body_zone": "Chest & Stomach",
    "gemstone": "Moonstone",
    "color": "Silver"
  },
  "personality": "Cancer is deeply intuitive, protective, and emotionally sensitive. They create safety through care—and remember every feeling, gift, and slight.",
  "sign_traits": {
    "strengths": [
      "Compassionate",
      "Intuitive",
      "Protective",
      "Loyal",
      "Imaginative"
    ],
    "challenges": [
      "Moody",
      "Overprotective",
      "Passive-aggressive",
      "Holds grudges",
      "Emotionally dependent"
    ],
    "core_archetype": "The Nurturer",
    "life_approach": "Cancer navigates life through feeling—seeking emotional resonance in every experience.",
    "modern_interpretation": "Cancer thrives in counseling, real estate, hospitality, and heritage industries—fields where emotional intelligence builds lasting value.",
    "spiritual_lesson": "Protection begins with self-compassion, not walls."
  },
  "compatibility_highlights": "Thrives with Scorpio (emotional depth) and Pisces (spiritual flow); challenged by Aries (bluntness) and Capricorn (emotional reserve).",
  "career_aptitudes": [
    "Therapist",
    "Chef",
    "HR Manager",
    "Family Law Attorney",
    "Home Stager"
  ],
  "sign_summary": "Cancer’s power lies in empathy and emotional intelligence. They nurture others instinctively but may confuse caretaking with self-worth. Their shadow is moodiness or passive aggression when hurt. Yet their loyalty is profound. Spiritually, Cancer learns that true safety comes from within—not from controlling others’ emotions. Coaches help Cancer clients set boundaries without guilt, especially during upheaval.",
  "sign_overview": "Cancer builds emotional security through connection and memory.",
  "sign_symbol": "♋",
  "sign_affirmation": "I honor my feelings and create safety from within.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "3d13477d1b6cc8f2",
    "quota": "unlimited",
    "usage_tracking": false
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.0",
    "endpoint_name": "horoscope_sign_personality",
    "endpoint_description": "Provides detailed personality traits 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.646656+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 and personality-focused descriptive fields.
Appends _enterprise and _api_metadata_.
This endpoint is deterministic sign-meaning content, not time-windowed transit output.