Zodiac Element¶

The Zodiac Element endpoint provides personalized readings for all zodiac signs grouped by their element (Fire, Earth, Air, Water). Each sign within an element receives a unique reading covering how that specific sign expresses the element'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/element`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/sign/element`

Request Parameters¶

GET Query¶

Name	Required	Type	Example	Description
`sign`	Yes	string	`fire`	Element to read: `fire`, `earth`, `air`, or `water`.

POST Body¶

Name	Required	Type	Example	Description
`sign`	Yes	string	`fire`	Element to read: `fire`, `earth`, `air`, or `water`.

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.

Element Groups¶

Element	Signs	Description
`fire`	Aries, Leo, Sagittarius	Energy, passion, action, creativity
`earth`	Taurus, Virgo, Capricorn	Stability, sensuality, practicality
`air`	Gemini, Libra, Aquarius	Intellect, communication, ideas
`water`	Cancer, Scorpio, Pisces	Emotion, intuition, depth

Example Requests¶

GET¶

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

POST¶

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

Example Response

{
  "element": "fire",
  "element_name": "Fire",
  "element_symbol": "🜂",
  "element_rulership": "Energy, passion, action, creativity and dynamic expression",
  "signs": {
    "aries": {
      "sign_name": "Aries",
      "sign_symbol": "♈",
      "sign_motto": "I Am",
      "core_archetype": "The Pioneer",
      "summary": "...",
      "detailed_meaning": "...",
      "sign_facts": { "..." },
      "element_in_sign": {
        "element_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": "..."
      }
    },
    "leo": { "..." },
    "sagittarius": { "..." }
  }
}

Open Dashboard

Note

Input: sign parameter (fire, earth, air, or water).
Response: All 3 signs in that element with personalized readings.
Languages: 26 supported via ?lang= parameter.
Validation:
Missing sign → 400
Invalid element → 400
Use Case: Element compatibility, personality insights, elemental balance.