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

# Jyotish Prashna Batch Endpoint

`POST /jyotish/prashna/batch`

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

Multi-option Prashna comparison (Block 5E).

Takes a master_seed + N labeled options (each with its own seed and
optional region / direction / per-option location). Returns the
deterministic ranked recommendation:

  - master_verdict  ("is the matter itself promised?" for the matter
    as a whole)
  - per-option briefs with the verdict and the timing tiers
  - a stable comparison_matrix the report renderer can table
  - top_choice + ranked_labels (deterministic — same input, same order)

The LLM may only EXPLAIN this packet. It must NOT invent a rank, a
top_choice or a timing_summary_label.

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

## Request body

- PrashnaBatchRequest
  - `master_seed` integer, required: Master question seed (the matter-itself gate)
  - `options` PrashnaBatchOption[], required
    - `label` string, required: Human-readable label, e.g. 'Wagga Wagga'
    - `seed_number` integer, required: BDA horary seed 1-249 for this option
    - `lat` number, nullable: Optional override of the querent location for this option
    - `lng` number, nullable
    - `tz` string, nullable
    - `region` string, nullable: Region tag (e.g. 'regional NSW', 'metro Sydney') — metadata only
    - `direction` string, nullable: Direction tag (e.g. 'north', 'south-east', 'interstate') — metadata only
  - `question` string, nullable
  - `question_domain` string, nullable: property|legal|sale|marriage|career|education|finance|health|travel|children
  - `question_schema` string, nullable: Multi-house schema key — overrides question_domain → schema mapping
  - `question_time_utc` string, nullable: ISO datetime when the question was asked (defaults to now UTC)
  - `lat` number, required: Default querent location latitude
  - `lng` number, required: Default querent location longitude
  - `tz` string, nullable
  - `birth_details` object, nullable: Optional birth details of the querent — applied to every option; 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)