Zodiac Modality¶

The Zodiac Modality endpoint provides personalized readings for all zodiac signs grouped by their modality (Cardinal, Fixed, Mutable). Each sign within a modality receives a unique reading covering how that specific sign expresses the modality's energy.

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/modality`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/sign/modality`

Request Parameters¶

GET Query¶

Name	Required	Type	Example	Description
`sign`	Yes	string	`cardinal`	Modality to read: `cardinal`, `fixed`, or `mutable`.

POST Body¶

Name	Required	Type	Example	Description
`sign`	Yes	string	`cardinal`	Modality to read: `cardinal`, `fixed`, or `mutable`.

Optional query parameter: lang=en|fr|es|de|pt|ja|hi|ar|ru|tr|it|pl|nl|id|ko|th|ro|ur|gu|bn|vi|ta|te|mr|pa|zh — all 26 supported languages.

Modality Groups¶

Modality	Signs	Description
`cardinal`	Aries, Cancer, Libra, Capricorn	Initiation, leadership, beginning
`fixed`	Taurus, Leo, Scorpio, Aquarius	Sustaining, stabilizing, maintaining
`mutable`	Gemini, Virgo, Sagittarius, Pisces	Adapting, modifying, transitioning

Example Requests¶

GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/sign/modality?sign=cardinal&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST¶

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

Example Response

{
  "modality": "cardinal",
  "modality_name": "Cardinal",
  "modality_symbol": "CARD",
  "modality_rulership": "Initiation, leadership, beginning, action and dynamic change",
  "signs": {
    "aries": {
      "sign_name": "Aries",
      "sign_symbol": "♈",
      "sign_motto": "I Am",
      "core_archetype": "The Pioneer",
      "summary": "...",
      "detailed_meaning": "...",
      "sign_facts": { "..." },
      "modality_in_sign": {
        "modality_expression": "...",
        "identity_core": "...",
        "ego_style": "...",
        "vitality_and_self_expression": "...",
        "strengths": ["...", "...", "...", "...", "..."],
        "challenges": ["...", "...", "...", "...", "..."],
        "purpose_and_career": "...",
        "love_and_relationships": "...",
        "shadow_and_growth": "...",
        "growth_lesson": "...",
        "compatibility_notes": "...",
        "symbolism_note": "...",
        "affirmation": "..."
      }
    },
    "cancer": { "..." },
    "libra": { "..." },
    "capricorn": { "..." }
  }
}

Open Dashboard

Note

Input: sign parameter (cardinal, fixed, or mutable).
Response: All signs in that modality with personalized readings.
Languages: 26 supported via ?lang= parameter.
Validation:
Missing sign → 400
Invalid modality → 400
Use Case: Modality compatibility, personality insights, behavioral patterns.