---
title: "Reports Timing Endpoint"
method: POST
path: "/reports/timing"
---

# Reports Timing Endpoint

`POST /reports/timing`

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

Dated timing forecast — the "good vs careful dated windows" view (BM-2).
Builds the member's stable birth-derived Jyotish bundle, computes the fresh
transit overlay (for the as-of anchor + the current Sade Sati overlay note),
runs the deterministic dasha-based timing picker
(timing_windows.compute_timing_windows, timing_v1) for the requested life-area,
and re-presents its favourable + caution windows as a structured, bilingual,
source-cited report asset (§7).

Every window — its dates, the active Mahādaśā/Antardaśā lords, score,
confidence and reasons — is carried VERBATIM from the picker; the favourable /
caution classification is the engine's own deterministic scoring, not a
fabricated verdict. §12 guidance-not-fatalism (a favourable window is an
opportunity to act, a caution window asks for care — neither is a fixed
outcome; the health domain adds a medical-decision caveat); no scripture
quoted; money-free. The LLM only narrates; this layer is pure templating.

## Request body

- TimingForecastRequest
  - `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
  - `domain` string: Life-area to forecast: career | marriage | education | finance | health | travel | spiritual.
  - `horizon_months` integer: How far ahead to scan the daśā tree (months, 1..120).

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