---
title: "Transit Endpoint"
method: POST
path: "/transit"
---

# Transit Endpoint

`POST /transit`

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

Transit (Gochar) & Sade-Sati report — the live, query-time transit overlay
rendered as a structured, bilingual, source-cited report asset (§7). Builds the
member's stable birth-derived Jyotish bundle, computes the FRESH transit overlay
over it (current gochar of the slow grahas with their house from the natal Moon
and Lagna, the live Sade Sati phase, Jupiter's transit favourability, and the
Vimshottari period running today), and re-presents it as an addressable asset.

This closes the gap the natal Dosha report disclosed: Sade Sati is transit-
dependent and was honestly NOT asserted there — this endpoint IS that current-
transit computation. Transit positions are pure astronomical core arithmetic over the
current sky; no astrological judgement is added and nothing is fabricated. §12
guidance-not-fatalism (a transit is a period, not a fate-verdict; Sade Sati is a
time of discipline, not a sentence of misfortune); no scripture quoted. The LLM
only narrates; this layer is pure templating.

## Request body

- TransitReportRequest
  - `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)