POST · VEDIC

Vimshottari Pran Dasha

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

Returns 9 Pran Dasha (finest period) entries for a specific Sookshma Dasha. This is the deepest level of the Vimshottari system — each Pran period lasts from a few hours down to minutes. Durations are in minutes.

Lazy-load chain (final step)
mahadashaantardashapratyantardashasookshmapran

Request body

All standard birth fields, plus:

FieldTypeRequiredDescription
year, month, day, hour, minuteintegerYesBirth date/time.
latitude, longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
mahadashastringYesPlanet name.
antardashastringYesPlanet name.
pratyantardashastringYesPlanet name.
sookshmastringYesPlanet name.

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

sookshma_period

The parent Sookshma Dasha that these Pran periods belong to.

FieldTypeDescription
start_datestringYYYY-MM-DD HH:MM.
end_datestringYYYY-MM-DD HH:MM.
duration_hoursnumberSookshma duration in hours.

pran_dashas[]

9 entries. Duration in minutes, timestamps with time-of-day.

FieldTypeDescription
planetstringPran lord.
start_datestringYYYY-MM-DD HH:MM.
end_datestringYYYY-MM-DD HH:MM.
duration_minutesnumberDuration in minutes.
is_balancebooleantrue for balance period.

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