API


Natal Horoscope

The Natal horoscope, also known as a birth horoscope, calculates a person's unique and personal astrological report based on birthdate, birthplace and birthtime. This is the most widely used horoscope.

Basic Flow

To generate a Natal Horoscope from the AstroAPI, the system (your implementation) makes a POST-request to the /api/natal endpoint with the necessary parameters. With correct parameters the AstroAPI will provide a full natal horoscope in JSON-format + the astrological wheel image url.

Generating a Natal Horoscope

POST /api/natal

Header Value
Accept-Encoding application/json
Authorization Bearer [accessToken]


body

{
    "name": "Matthias",
    "date": "1984-03-27",
    "time": "13:13",
    "place_id": 1250015082,
    "lang": "en",
    "system": "p"
}


Params explanation

Header Value
name The name of the person or event you wish to create a natal horoscope for
date The (birth)date of the person or event in format YYYY-mm-dd
time The (birth)time of the person or event in format HH:mm
place_id The (birth)place of the person or event retrieved from the /api/places request
lang The language you wish to receive the astrological interpretation texts associated with the horoscope in. Default: 'nl'
system The House system: or "p" (Placidus), "k" (Koch) or "x" (Meridian House system)

Response

Example response for Lady Gaga


Full JSON-response Page Full JSON-response File


JSON-object Astrological naming Explanation Custom Text
profile Information about the person/event this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
intro Text as intro with general info about the natal horoscope. Yes
planets Planets in Signs Influence of the planets on the person/event. Calculation for each planet. *e.g. Jupiter in Aries in House 4 Yes
elements Basic Elements Strength of the different planets on the horoscope. Yes
zodiacpoints Zodiac Elements Strength Strength of the zodiac signs in the horoscope. e.g. Taurus: strength 5 Yes (for strength > 4)
housecusps House Cusps The signs on the different house cusps of the astrological chart Yes
aspects Aspects The interplanetary relations in degrees that form bonds. *e.g. 180° = Opposite aspect Yes
wheel Astrological Wheel URL to the generated Astrological wheel based on the horoscope calculation. -


Astrological wheel

...
"wheel": "/img/example_wheel.png"
}

image