POST · VEDIC

Purnima Dates

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

Returns the month's Purnima (full moon) dates with both reckonings side by side: the astronomical full moon (darsha — tithi midpoint, used for moon-sighting rituals) and the Udaya-Tithi observance date (sunrise rule, with Vriddhi/Kshaya handling when the tithi spans two sunrises or none). Each entry carries its festival identity (e.g. Jyeshtha Purnima = Vat Purnima), Hindu month in both systems, adhik flag, the full tithi window, and a dates_differ flag for the cases where ritual and observance dates split.

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 — the list is filtered to this month; summary and next still consider the whole year.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone (e.g. Asia/Kolkata).

Response shape

FieldTypeDescription
purnimas[]arrayPer entry: name + Hindi, alt_name/significance (attached vrat or festival), is_adhik, hindu_month (both systems), darsha_purnima (astronomical date + full-moon time), udaya_tithi (observance date, tithi type normal/vriddhi/kshaya, sunrise count), dates_differ, tithi_window.
nextobjectThe next upcoming Purnima from today (same shape).

Errors

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

See also