POST · VEDIC

Chara Dasha Mahadasha

Endpoint POST https://starsapi.com/api/v3/vedic/jaimini/chara-dasha-mahadasha

Returns the 12 Rashi Dasha (sign-based Mahadasha) periods of the Jaimini Chara Dasha system, plus the currently running dasha. Unlike Vimshottari (planet-based), Chara Dasha assigns periods to zodiac signs, with durations determined by the sign lord’s position (BPHS counting method).

Lazy-load chain
chara-dasha-mahadashaantardashapratyantardashasookshmapran

Authentication

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

Request body

FieldTypeRequiredDescription
yearintegerYesBirth year, 4-digit.
monthintegerYesBirth month, 112.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour format.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees, −90…90.
longitudenumberYesDecimal degrees, −180…180.
timezonestringYesIANA timezone identifier.
ayanamsastringNoDefault lahiri. Full list →
node_typestringNomean (default) or true.

Response shape

calculation_method

FieldTypeDescription
lagna_sign / lagna_sign_enstringAscendant sign (Hindi / English).
lagna_typestringOdd-footed (Samapada) or Even-footed (Vishamapada).
dasha_directionstringZodiacal (forward) or Anti-zodiacal (backward), based on lagna footedness.
duration_methodstringLord’s position counting per BPHS.

current_dasha

FieldTypeDescription
mahadashaobjectCurrent Rashi Dasha: sign, sign_number, sign_lord, start_date, end_date.
antardashaobjectCurrent sub-period (same fields).
pratyantardashaobject|nullCurrent sub-sub-period if computed.

mahadasha_table

12 sign periods. No nested sub-periods — fetch via antardasha endpoint.

FieldTypeDescription
signstringSign name (English).
sign_numberinteger1 (Aries) – 12 (Pisces).
sign_lordstringRuling planet of the sign.
duration_yearsintegerPeriod duration (1–12 years, from lord’s position).
start_date / end_datestringYYYY-MM-DD.
planets_in_signarrayNatal planets placed in this sign.
is_currentbooleantrue for the active period.

Next step: Antardasha

Pass the tapped row’s sign (name) or sign_number as the mahadasha parameter to the Antardasha endpoint.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATE / INVALID_TIMEBad date or time value.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
405METHOD_NOT_ALLOWEDNon-POST request.

See also