POST · VEDIC

Yogini Antardasha

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

Returns 8 Yogini Antardasha periods for a specific main Yogini. Call this when a user taps/expands a Yogini row from the Mahadasha endpoint.

Lazy-load chain
yogini-mahadashayogini-antardashayogini-pratyantardashayogini-sookshmayogini-pran

Request body

All standard birth fields, plus:

FieldTypeRequiredDescription
year, month, day, hour, minuteintegerYesBirth date/time.
latitude, longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
yoginistringYesYogini name: Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, or Sankata.
yogini_start_datestringYesYYYY-MM-DD — the start_date of the Yogini row from the Mahadasha response. Uniquely identifies which Yogini period to expand.
Tip Copy yogini and start_date directly from the Mahadasha row the user tapped. No cycle number needed — the start date is the unique identifier.

Response shape

yogini_period

The parent Yogini period that these sub-periods belong to.

FieldTypeDescription
start_datestringYYYY-MM-DD.
end_datestringYYYY-MM-DD.
duration_daysnumberDuration in days.

sub_yoginis[]

8 Sub-Yogini entries within the requested Yogini.

FieldTypeDescription
yoginistringSub-Yogini name.
planetstringAssociated planet.
start_datestringYYYY-MM-DD.
end_datestringYYYY-MM-DD.
duration_daysnumberDuration in days.
is_balancebooleantrue for the first (balance) sub-period.

Next step: Pratyantardasha

Pass the same yogini + yogini_start_date, plus the tapped row’s yogini name as sub_yogini, to the Pratyantardasha endpoint.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent (including yogini and yogini_start_date).
400INVALID_PARAMInvalid Yogini name or bad date format.
400INVALID_DASHA_PATHYogini with given start date not found in sequence.
405METHOD_NOT_ALLOWEDNon-POST request.

See also