Birth Chart Report¶

The Birth Chart endpoint provides a complete astrological report including:

Planetary positions (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto)
Nodes (True/Mean North & South Nodes)
Chiron, Lilith, and other significant points
Houses (1–12) using the selected house system
Ascendant, Descendant, Medium Coeli, Imum Coeli
Lunar phase and local/UTC datetime
Zodiac sign, element, and quality for each planet/house
Retrograde status indicators

Use this endpoint for personal astrology readings, horoscope generation, and astrological analysis.

Endpoint¶

Method	Path
`GET`	`https://the-numerology-api.p.rapidapi.com/birth-chart`
`POST`	`https://the-numerology-api.p.rapidapi.com/birth-chart`

Query Parameters¶

Name	Required	Type	Example	Description
`name`	✅	String	`John Doe`	Full name of the person.
`year`	✅	Number	`1990`	Birth year (e.g. 1990).
`month`	✅	Number	`7`	Birth month (1–12).
`day`	✅	Number	`16`	Birth day (1–31).
`hour`	❌	Number	`12`	Hour of birth (0–23). Default: `12`.
`minute`	❌	Number	`0`	Minute of birth (0–59). Default: `0`.
`lat`	✅	Number	`48.8566`	Latitude of birthplace.
`lng`	✅	Number	`2.3522`	Longitude of birthplace.
`city`	✅	String	`Paris`	City of birth.
`country`	✅	String	`FR`	Country code or name.
`tz`	❌	String	`Europe/Paris`	Timezone string (defaults to UTC).

Note

The endpoint supports both GET and POST methods.
Use POST when sending structured JSON bodies, or GET for quick URL-based requests.

Example Requests¶

GET Request¶

curl -X GET "https://the-numerology-api.p.rapidapi.com/birth-chart?name=John%20Doe&year=1990&month=7&day=16&lat=48.8566&lng=2.3522&city=Paris&country=FR&tz=Europe/Paris" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

POST Request¶

curl -X POST "https://the-numerology-api.p.rapidapi.com/birth-chart" \
  -H "Content-Type: application/json" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -d '{
        "name": "John Doe",
        "year": 1990,
        "month": 7,
        "day": 16,
        "hour": 12,
        "minute": 0,
        "lat": 48.8566,
        "lng": 2.3522,
        "city": "Paris",
        "country": "FR",
        "tz": "Europe/Paris"
      }'

Example Response¶

{
  "name": "John Doe",
  "birth_chart": {
    "ascendant": {
      "abs_pos": 177.33,
      "element": "Earth",
      "emoji": "♍️",
      "house": "First_House",
      "name": "Ascendant",
      "point_type": "AxialCusps",
      "position": 27.33,
      "quality": "Mutable",
      "retrograde": false,
      "sign": "Vir",
      "sign_num": 5
    },
    "sun": {
      "abs_pos": 113.62,
      "element": "Water",
      "emoji": "♋️",
      "house": "Tenth_House",
      "name": "Sun",
      "point_type": "Planet",
      "position": 23.62,
      "quality": "Cardinal",
      "retrograde": false,
      "sign": "Can",
      "sign_num": 3
    },
    "moon": {
      "abs_pos": 36.22,
      "element": "Earth",
      "emoji": "♉️",
      "house": "Eighth_House",
      "name": "Moon",
      "point_type": "Planet",
      "position": 6.22,
      "quality": "Fixed",
      "retrograde": false,
      "sign": "Tau",
      "sign_num": 1
    },
    "houses_names_list": [
      "First_House", "Second_House", "Third_House", "Fourth_House",
      "Fifth_House", "Sixth_House", "Seventh_House", "Eighth_House",
      "Ninth_House", "Tenth_House", "Eleventh_House", "Twelfth_House"
    ],
    "planets_names_list": [
      "Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter",
      "Saturn", "Uranus", "Neptune", "Pluto", "Mean_Node",
      "True_Node", "Mean_South_Node", "True_South_Node",
      "Chiron", "Mean_Lilith"
    ],
    "local_time": 12,
    "iso_formatted_local_datetime": "1990-07-16T12:00:00+02:00",
    "iso_formatted_utc_datetime": "1990-07-16T10:00:00+00:00",
    "lunar_phase": {
      "moon_phase": 22,
      "moon_phase_name": "Last Quarter",
      "moon_emoji": "🌗",
      "sun_phase": 22
    },
    "zodiac_type": "Tropic"
  }
}

View on RapidAPI

Note

The birth_chart object includes planets, houses, nodes, and key points with detailed astrological properties such as: - Element (Fire, Earth, Air, Water) - Quality (Cardinal, Fixed, Mutable) - Sign and retrograde status
Also includes formatted local/UTC times and lunar phase details for precise charting.