---
title: "Houses Endpoint"
method: POST
path: "/houses"
---

# Houses Endpoint

`POST /houses`

## Request

- Base URL: `https://jyotish-api.bda.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://jyotish-api.bda.ai/houses`
- Auth: none declared

Bhava (house) report — the full 12-house analysis the engine computes in the
rashi-based system, rendered as a structured, bilingual, source-cited report asset
(§7). Pure: it builds the personal Jyotish bundle and re-presents the deterministic
house structure it ALREADY computes — each house's sign, ruling lord and where that
lord sits (with its dignity), the planets occupying the house, the planets aspecting
it (graha drishti), and the engine's own classical signification — no house outcome,
strength, or prediction is fabricated. §12 guidance-not-fatalism; no scripture
quoted. The LLM only narrates; this layer is pure templating.

## Request body

- HousesReportRequest
  - `name` string, nullable
  - `gender` string, nullable
  - `date_of_birth` string, date, required
  - `time_of_birth` string, required: HH:MM:SS in local time
  - `time_accuracy` string: exact|approximate|unknown
  - `lat` number, required
  - `lng` number, required
  - `tz` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service.md) · [All operations](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/llms.txt) · [OpenAPI document](https://skmtc.dev/bda/apis/bda-jyotish-panchang-service/revisions/90f241bf4009?raw)