POST/api/astro/planet_transit_over_house/1 credit

Transit over house

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.

https://yogataraapi.prahlad.app/api/astro/planet_transit_over_house/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/planet_transit_over_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'

Response

{
  "data": {
    "get_planet_transit_over_house": [
      "Irritable temper",
      "Gains physical strength, fame, and honour"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data, keyed by what you requested.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.