POST · VEDIC

Vimshottari Antardasha

Endpoint POST https://starsapi.com/api/v3/vedic/dashas/vimshottari-antardasha

Returns the 9 Antardasha (sub-period) entries within a specific Mahadasha. Pass the planet value from a Mahadasha row as the mahadasha parameter.

Lazy-load chain
mahadashaantardashapratyantardashasookshmapran

Authentication

MethodExample
Header (recommended)X-Api-Key: sa_live_xxxxxxxxxxxx
BearerAuthorization: Bearer sa_live_xxxxxxxxxxxx
Query?api_key=sa_live_xxxxxxxxxxxx

Request body

All standard birth fields, plus:

FieldTypeRequiredDescription
yearintegerYesBirth year.
monthintegerYes112.
dayintegerYesDay of month.
hourintegerYes24-hour format.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYes−90…90.
longitudenumberYes−180…180.
timezonestringYesIANA timezone.
ayanamsastringNoDefault lahiri.
node_typestringNomean or true.
mahadashastringYesPlanet name: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, or Ketu.

Ayanamsa & KP usage

Vimshottari periods are derived from the Moon’s nakshatra position, which shifts with the chosen ayanamsa. Lahiri and Krishnamurti (KP) differ by roughly 5–6 arc-minutes — enough to shift dasha start/end dates by several days, and at deeper levels (Sookshma/Pran) even change the running lord. KP practitioners should pass "ayanamsa": "krishnamurti" (alias kp); variants kp_new and kp_senthil are also supported. The ayanamsa actually used is echoed in the response meta for verification. Unknown ayanamsa names return an error rather than silently falling back to Lahiri.

Response shape

dasha_path

FieldTypeDescription
mahadashastringThe Mahadasha planet you requested.

mahadasha_period

FieldTypeDescription
start_datestringMahadasha start (YYYY-MM-DD).
end_datestringMahadasha end.
duration_daysnumberActual duration in days.
yearsintegerFull period years (e.g. 16 for Jupiter).

antardashas[]

9 Antardasha entries within the requested Mahadasha.

FieldTypeDescription
planetstringAntardasha lord.
start_datestringYYYY-MM-DD.
end_datestringYYYY-MM-DD.
duration_daysnumberDuration in days.
is_balancebooleantrue if this is the balance sub-period.

Next step: Pratyantardasha

Pass mahadasha + the tapped row’s planet as antardasha to the Pratyantardasha endpoint.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent (including mahadasha).
400INVALID_PARAMInvalid planet name.
400INVALID_DASHA_PATHMahadasha planet not found in sequence for birth data.
405METHOD_NOT_ALLOWEDNon-POST request.
500COMPUTE_ERRORUnknown ayanamsa name.

See also