curl -X POST https://yogataraapi.prahlad.app/api/astro/house_lord_particular_house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_house_lord"],"house":"lagna","number":4}'The lord of a house carries that house's matters wherever it goes, so the classics have a specific statement for each of the 144 combinations — twelve lords in twelve places. This endpoint returns the statement for one pair. Name the house whose lord you mean in house, using this endpoint's Sanskrit bhava names — lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya for the first through the twelfth — and give the house it is placed in as number, 1 to 12. Note that /api/astro/effect_house_lord_different_house/ covers the same ground with a different set of names and different text; the two are not interchangeable. Nothing is computed from a chart, so no date, time or place is sent — work out the lord's placement yourself first. An unknown house name or an out-of-range number returns HTTP 200 carrying the string 'Invalid key: …' rather than an error status. The single key is get_house_lord.
| Field | Type | Required | Notes |
|---|---|---|---|
| house | string | required | lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyayaThe bhava whose LORD is being placed: lagna = 1st... vyaya = 12th. WARNING: this endpoint uses a DIFFERENT naming set from /api/astro/effect_house_lord_different_house/ - here the 5th/6th/7th/8th/9th are 'putra', 'satru', 'yuvati', 'randhara' (note the extra 'a': randhAra) and 'dharma'. Lowercased by. An unknown value returns 200 with "Invalid key: <x>". |
| 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_lordArray of strings; only one key exists. |
| number | integer | required | 123456789101112Integer 1-12 - the house that lord is placed in. Out-of-range returns 200 with "Invalid key: <n>". |
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_lord | house, number | The classical results of one house's lord occupying another: house names the bhava whose lord it is, number the house it sits in. Returns a list of short English statements, usually one to three, such as 'Blessed with paternal and maternal happiness'. Reference text keyed by the pair, with nothing derived from a chart. |