https://vedintelastroapi.com/api/v1/panchang/pradosh-vrat-yearReturns all Pradosh Vrat observance dates for a full year (~24–25 entries: Shukla + Krishna Trayodashi each lunar month, plus adhika-masa months). Same rule and null-field semantics as pradosh-vrat. Null-date rows have sunset_utc/unix, pradosh_kaal_end_utc/unix, and duration all null. True-ambiguous rows (ambiguous:true) have ambiguous_candidates with suggested_by_overlap (true on the candidate with greatest overlap, false on others). No_sunset_in_tithi rows (ambiguous:false, no_sunset_in_tithi:true) have info-only ambiguous_candidates without suggested_by_overlap. A units block is included. lat and lon are required; unknown rule values return 400 with error INVALID_INPUT, field "rule", message 'Unknown rule "bogus". Must be one of: sunset_trayodashi, full_kaal_trayodashi, max_overlap.', suggestion 'Omit rule to use the default (sunset_trayodashi), or pass one of the three valid values.'. Missing lat returns field "lat", message 'Missing required parameter: "lat".', suggestion 'Provide latitude (lat) and longitude (lon) in decimal degrees. Example: lat=28.6139&lon=77.2090'. Open to all plans.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| api_key | query | Yes | string | Your VedIntel™ AstroAPI key. Get one at https://vedintelastroapi.com/auth/signupe.g. vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| year | query | No | integer | Year (e.g. 2026). Defaults to current year. |
| lat | query | Yes | number | Birth latitude with decimalse.g. 11 |
| lon | query | Yes | number | Birth longitude with decimalse.g. 77 |
| tz | query | Yes | number | Timezone offset from UTC. IST = 5.5e.g. 5.5 |
| rule | query | No | string sunset_trayodashi | full_kaal_trayodashi | max_overlap default: sunset_trayodashi | Observance rule. sunset_trayodashi (default): Trayodashi present at sunset. full_kaal_trayodashi: Trayodashi spans entire Pradosh Kaal. max_overlap: pick the day with greatest overlap. Any other value returns 400. |
curl -X GET "https://vedintelastroapi.com/api/v1/panchang/pradosh-vrat-year?api_key=vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&year=VALUE&lat=11&lon=77&tz=5.5&rule=sunset_trayodashi" \
-H "X-API-Key: YOUR_API_KEY"{
"status": 200,
"response": {
"year": 2026,
"lat": 28.6139,
"lon": 77.209,
"tz": 5.5,
"rule": "sunset_trayodashi",
"count": 25,
"pradosh_vrats": [
{
"date": "01/01/2026",
"weekday": "Thursday",
"paksha": "Shukla",
"tithi_number": 13,
"tithi_start_utc": "2025-12-31T20:18:26Z",
"tithi_end_utc": "2026-01-01T16:52:42Z",
"tithi_start_unix": 1767212306,
"tithi_end_unix": 1767286362,
"sunset_utc": "2026-01-01T12:05:27Z",
"sunset_unix": 1767269127,
"pradosh_kaal_end_utc": "2026-01-01T14:49:11Z",
"pradosh_kaal_end_unix": 1767278951,
"pradosh_kaal_duration_minutes": 164,
"vrat_type": "Pradosh",
"ambiguous": false,
"no_sunset_in_tithi": false,
"rule_applied": "sunset_trayodashi",
"observance_window": "sunset to sunset plus one fifth of the night (sunset to next sunrise), as used by the VedIntel™ AstroAPI festival engine; other traditions use other windows",
"atpress": 1013.25,
"attemp": 15,
"sun_limb": "upper_limb",
"ephemeris_version": "2.09.03"
},
{
"date": "16/01/2026",
"weekday": "Friday",
"paksha": "Krishna",
"tithi_number": 28,
"tithi_start_utc": "2026-01-15T14:46:59Z",
"tithi_end_utc": "2026-01-16T16:52:09Z",
"tithi_start_unix": 1768488419,
"tithi_end_unix": 1768582329,
"sunset_utc": "2026-01-16T12:17:00Z",
"sunset_unix": 1768565820,
"pradosh_kaal_end_utc": "2026-01-16T14:58:32Z",
"pradosh_kaal_end_unix": 1768575512,
"pradosh_kaal_duration_minutes": 162,
"vrat_type": "Pradosh",
"ambiguous": false,
"no_sunset_in_tithi": false,
"rule_applied": "sunset_trayodashi",
"observance_window": "sunset to sunset plus one fifth of the night (sunset to next sunrise), as used by the VedIntel™ AstroAPI festival engine; other traditions use other windows",
"atpress": 1013.25,
"attemp": 15,
"sun_limb": "upper_limb",
"ephemeris_version": "2.09.03"
},
{
"date": null,
"weekday": null,
"paksha": "Shukla",
"tithi_number": 13,
"tithi_start_utc": "2026-04-28T13:22:20Z",
"tithi_end_utc": "2026-04-29T14:22:05Z",
"tithi_start_unix": 1777382540,
"tithi_end_unix": 1777472525,
"sunset_utc": null,
"sunset_unix": null,
"pradosh_kaal_end_utc": null,
"pradosh_kaal_end_unix": null,
"pradosh_kaal_duration_minutes": null,
"vrat_type": "Pradosh (ambiguous)",
"ambiguous": true,
"ambiguous_candidates": [
{
"date": "28/04/2026",
"weekday": "Tuesday",
"trayodashi_present_at_sunset": true,
"trayodashi_overlap_minutes_with_pradosh_kaal": 129.6,