---
title: "Jyotish Prashna Endpoint"
method: POST
path: "/jyotish/prashna"
---

# Jyotish Prashna Endpoint

`POST /jyotish/prashna`

## 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/jyotish/prashna`
- Auth: none declared

BDA horary judgement. Returns the deterministic Prashna packet —
the horary ascendant for the query, the planets at question time, the
question-house analysis, the verdict with its confidence, and the
Prashna-Moon dasha timing with its favourable / avoid windows.

The LLM may only EXPLAIN the packet. It must never invent an ascendant,
a supporting planet, a verdict or a timing period.

(This description is a PUBLISHED contract surface — it is served
verbatim in /openapi.json. State what the endpoint returns, never how
the packet is constructed: owner directive 2026-08-26.)

## Request body

- PrashnaRequest
  - `seed_number` integer, required: BDA horary number 1-249
  - `question` string, nullable
  - `question_domain` string, nullable: property|marriage|career|education|finance|health|travel|legal|sale|...
  - `question_house` integer, nullable: Explicit house 1-12 (overrides question_domain → single-house verdict)
  - `question_schema` string, nullable: Multi-house schema key — property|legal|sale|marriage|career|education|finance|health|travel|children. Overrides question_domain → multi-house schema mapping.
  - `question_time_utc` string, nullable: ISO datetime when the question was asked (defaults to now UTC)
  - `lat` number, required
  - `lng` number, required
  - `tz` string, nullable
  - `counterparty_birth_details` MatchPerson
    - `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
    - `lat` number, required
    - `lng` number, required
    - `tz` string, nullable
  - `birth_details` object, nullable: Optional birth details of the querent: {date_of_birth, time_of_birth, birth_lat, birth_lng, birth_tz}. Supplying them lets the answer say whether the asker's own chart agrees, and improves answer quality.

## 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)