API

Transits Horoscope

The Transits horoscope calculates the aspects between the horoscopes of 2 persons. Naturally for this type of horoscope 2 sets of birthdata are needed.

Basic Flow

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

Generating a Transits Horoscope

POST /api/transits

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


body

{
    "name_1": "Matthias",
    "date_1": "1984-03-27",
    "time_1": "13:13",
    "place_id_1": 1250015082,

    "name_2": "Lady Gaga",
    "date_2": "1986-03-28",
    "time_2": "22:55",
    "place_id_2": 1840034016,

    "lang": "en"
}


Params explanation

Header Value
name The name of the person or event you wish to create a transits 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
lang The language you wish to receive the astrological interpretation texts associated with the horoscope in. Default: 'nl'

Response

Example response for Transits


Full JSON-response File


JSON-object Astrological naming Explanation Custom Text
profile1 Information about the Person this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
profile2 Information about the Event this astrological profile is about. Info about converted Birthdata to UTC, latitude/longitude, timezone -
transits_aspects Transit Aspects The interplanetary relations in degrees that form bonds. *e.g. 180° = Opposite aspect . These aspects are the bonds between the Person and the Event Yes
transits_houses Transit Houses Resulting House positions formed by the combination of astrological profiles of the Person and the Event Yes
wheel1 Astrological Wheel URL to the generated Astrological wheel based on the horoscope calculation between the Person and the Event. -


Astrological wheel

...
    "wheel": "https://api.bloom.be/images/horo2_1569945515_9a46870d59e34df4.png",
}

Transits wheel

image