Skip to content
Occult API
POST/api/astro/house_information/1 credit

House significations

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.

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

FieldTypeRequiredNotes
house_numberintegerrequired
123456789101112
keysarrayrequired

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.

KeyExtra fields neededDescription
get_house_infohouse_numberThe 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.

Example request

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

Response

{
  "data": {
    "get_house_info": {
      "other names": "Sukha Bhava",
      "element & quality": "Movable, Water",
      "description": "The 4th house represents comfort, emotional happiness, and inner peace. It is deeply tied to one's home, mother, vehicles, land, and personal well-being. It is also connected to learning, cultural roots, and sacred knowledge. As the house of shelter, nurturing, and support, it governs the environments that provide safety and emotional grounding.",
      "keywords & significations": {
        "Comfort & Happiness": [
          "emotional peace",
          "joy",
          "contentment",
          "domestic bliss",
          "the source of one's sense of well-being"
        ],
        "Mother & Maternal Side": [
          "mother",
          "maternal relatives",
          "relationship with maternal lineage"
        ],
        "Home & Property": [
          "house",
          "real estate",
          "property matters",
          "living space",
          "entering a new home",
          "ancestral property",
          "loss of residence"
        ],
        "Conveyance & Travel": [
          "vehicles (rickshaws, boats, etc.)",
          "means of transportation",
          "local travel"
        ],
        "Land & Agriculture": [
          "land",
          "agriculture",
          "fertile fields",
          "gardens",
          "ponds and wells (including construction)",
          "land arising from islands or wet zones",
          "grain from wetlands"
        ],
        "Learning & Intellect": [
          "learning",
          "sacred texts",
          "wise counsel",
          "pure intellect"
        ],
        "Physical Comforts": [
          "perfumes",
          "clothing",
          "ornaments",
          "oil baths",
          "water and drinks",
          "celestial foods"
        ],
        "Cultural & Spiritual Values": [
          "castes",
          "rites",
          "religion-based education",
          "victory in personal efforts",
          "divine remedies"
        ],
        "Family & Relations": [
          "relatives",
          "well-wishers",
          "father",
          "wife",
          "friends",
          "children of siblings"
        ],
        "Security & Wealth": [
          "securing of savings",
          "stable financial base",
          "result or conclusion of efforts"
        ],
        "Animals & Livelihood": [
          "cattle (cows, buffaloes)",
          "horses",
          "elephants",
          "domestic animals for livelihood"
        ],
        "Creative & Domestic Arts": [
          "architecture",
          "art",
          "house-building skills",
          "pavilions",
          "layout and use of spaces"
        ],
        "Challenges": [
          "false accusations",
          "loss of home",
          "tiring or exhausting work"
        ],
        "Unique Aspects": [
          "trust",
          "noble reputation",
          "guidance in locating lost or hidden items",
          "anthills"
        ]
      },
      "astrological info": {
        "4th Lord (4L)": "Plays a pivotal role in determining sources of emotional comfort and security. Its placement, dignity, and the Bhava it occupies are key",
        "Planets in 4H": "Influence the nature of one's peace and comforts. When placed in their own, exalted, or friendly signs, they enhance well-being. If debilitated or afflicted by challenging combinations, the associated areas may become sources of discomfort",
        "Karaka Planets": "Moon – for mother and emotional nourishment; Venus – for conveyances, comforts, and pleasures; Mars – for land and property",
        "General Rule": "Strong, benefic influences on the 4th house and its lord lead to happiness, prosperity at home, and mental tranquility. Affliction or weakness indicates emotional disturbances or issues related to home and domestic life"
      }
    }
  },
  "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.