POSThttps://yogataraapi.prahlad.app/api/astro/house_information/

House significations

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://yogataraapi.prahlad.app/api/astro/house_information/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_house_info"],"house_number":4}'

Every house of a chart — the twelve bhavas — governs a bundle of life matters: the fourth home and mother, the seventh partnership, the tenth career. This endpoint returns the reference sheet for one of them: what it stands for, its element and quality, the themes it rules grouped under headings, and how to judge it from the house lord, the planets in it and its natural significators. It is a lookup, not a calculation. You pass house_number from 1 to 12 and get the same text back every time — no birth date, time or place is involved. Use it to label a chart you have already computed elsewhere, or to fill an explanatory panel beside one. The single key is get_house_info. A number outside 1-12 returns the string 'Invalid house number' with HTTP 200 rather than an error status.

Request fields

Field Type Required Notes

house_number

integer

Field	Type	Required	Notes
house_number	integer	required	`123456789101112`
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. `get_house_info` Array of strings; only one key exists. NOTE the config file is named 'house_informations' (plural) while the route is /api/astro/house_information/.

required

123456789101112

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.

get_house_info

Array of strings; only one key exists. NOTE the config file is named 'house_informations' (plural) while the route is /api/astro/house_information/.

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_house_info	house_number	The full significations of one bhava, selected by house_number 1-12. Returns an object with 'other names' (its Sanskrit name, e.g. Sukha Bhava), 'element & quality', a prose 'description', 'keywords & significations' — a dictionary of themed groups, each a list of phrases — and 'astrological info', four notes covering the house lord, planets placed there, the natural significators and a general rule for judging it. Static reference text, identical for every request.

Full reference for this endpoint