Prewritten readings for a planet transiting a given house of the birth chart: what the Sun's passage through the third house is said to bring, what Saturn's through the seventh is said to bring, and so on, for nine planets across twelve houses.
A pure lookup — supply `planet` and `house` and get the text back. No date, time or place is involved, so pair it with a calculation that tells you which house each planet currently occupies.
Use it alongside `/api/astro/planet_transit_natal_planets/`, which covers the other half of a transit report: a transiting planet's contact with a natal planet rather than with a house.
Request fields
Field
Type
Required
Notes
house
integer
required
keys
array
required
Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
planet
string
required
sunmoonmarsmercuryjupitervenussaturnrahuketu
Exact lower-case match. An unknown value returns "Invalid key: <x>" with HTTP 200. (The companion `house` field is an integer index into a list, 0-based - see the __main__ example at.
Available keys (1)
Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.
Key
Extra fields needed
Description
get_planet_transit_over_house
planet, house
The reading for `planet` transiting the house given by `house`. Returns a list of short phrases, usually two to four, each a separate statement about that passage.