POST · VEDIC

Vimshottari Pratyantardasha

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

Returns 9 Pratyantardasha (sub-sub-period) entries for a specific Mahadasha–Antardasha combination.

Lazy-load chain
mahadashaantardashapratyantardashasookshmapran

Request body

All standard birth fields, plus:

FieldTypeRequiredDescription
year, month, day, hour, minuteintegerYesBirth date/time.
latitude, longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
mahadashastringYesPlanet name (e.g. Jupiter).
antardashastringYesPlanet name (e.g. Venus).

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

pratyantardashas[]

9 entries within the specified Antardasha.

FieldTypeDescription
planetstringPratyantardasha lord.
start_datestringYYYY-MM-DD.
end_datestringYYYY-MM-DD.
duration_daysnumberDuration in days.
is_balancebooleantrue for balance sub-period.

Next step

Add the tapped row’s planet as pratyantardasha and call Sookshma Dasha.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_PARAMInvalid planet name.
400INVALID_DASHA_PATHPlanet not found in dasha sequence.
405METHOD_NOT_ALLOWEDNon-POST request.
500COMPUTE_ERRORUnknown ayanamsa name.

See also