POST/api/astro/house_lord_particular_house/1 credit

House lord placement

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.

https://yogataraapi.prahlad.app/api/astro/house_lord_particular_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

string

Field	Type	Required	Notes
house	string	required	`lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya` The 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_lord` Array of strings; only one key exists.
number	integer	required	`123456789101112` Integer 1-12 - the house that lord is placed in. Out-of-range returns 200 with "Invalid key: <n>".

required

lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

The 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_lord

Array of strings; only one key exists.

number

integer

required

123456789101112

Integer 1-12 - the house that lord is placed in. Out-of-range returns 200 with "Invalid key: <n>".

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_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.

Example request

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}'

Response

{
  "data": {
    "get_house_lord": [
      "Blessed with paternal and maternal happiness",
      "Gains many brothers, is charming, virtuous, and has a passionate nature"
    ]
  },
  "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.