POST · VEDIC

Choghadiya

Endpoint POST https://starsapi.com/api/v3/vedic/panchang/choghadiya

Returns the day's full Choghadiya table — 8 day muhurtas (sunrise→sunset) and 8 night muhurtas (sunset→next sunrise), each with its name (Amrit, Shubh, Labh, Chal, Udveg, Kaal, Rog), auspicious/neutral/inauspicious type, and planetary lord. The sequence rotates by weekday per the classical table; portion lengths follow the actual local day/night durations.

When the requested date is today, current points at the running choghadiya — ready for muhurta pickers and live widgets. (Sample below is truncated; the live response carries all 16 windows.)

Authentication

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

Request body

FieldTypeRequiredDescription
yearintegerYesCalendar year.
monthintegerYesMonth, 1–12.
dayintegerYesDay of month.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone (e.g. Asia/Kolkata).

Response shape

FieldTypeDescription
currentobjectThe choghadiya running at request time (today only).
day[]array8 windows sunrise→sunset: period, name, type (Auspicious / Neutral / Inauspicious), lord, start/end.
night[]array8 windows sunset→next sunrise, same shape. Times past midnight roll into the next calendar day.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
405METHOD_NOT_ALLOWEDNon-POST request.

See also