https://vedintelastroapi.com/api/v1/panchang/pradosh-vratReturns Pradosh Vrat observance dates for a given month and year. Pradosh Kaal is from sunset to sunset plus one fifth of the night (sunset to next sunrise) — this is the convention used here and is not universal. Includes weekday classification (Som/Bhaum/Shani Pradosh), ambiguity detection, and no_sunset_in_tithi handling (a tithi with no sunset inside its window — ambiguous:false, ambiguous_candidates info-only with no suggested_by_overlap). True-ambiguous rows (two sunsets in tithi) have ambiguous:true and ambiguous_candidates with suggested_by_overlap on the candidate with greatest overlap. Null-date rows (true-ambiguous or no_sunset_in_tithi) have sunset_utc, sunset_unix, pradosh_kaal_end_utc, pradosh_kaal_end_unix, and pradosh_kaal_duration_minutes all null. Each entry includes refraction metadata (atpress 1013.25 hPa, attemp 15 °C, sun_limb upper_limb). A units block is included in every response. 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 |
| month | query | No | integer | Month (1–12). Defaults to current month. |
| 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?api_key=vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&month=VALUE&year=VALUE&lat=11&lon=77&tz=5.5&rule=sunset_trayodashi" \
-H "X-API-Key: YOUR_API_KEY"{
"status": 200,
"response": {
"month": 11,
"year": 2026,
"lat": 28.6139,
"lon": 77.209,
"tz": 5.5,
"rule": "sunset_trayodashi",
"count": 2,
"pradosh_vrats": [
{
"date": "06/11/2026",
"weekday": "Friday",
"paksha": "Krishna",
"tithi_number": 28,
"tithi_start_utc": "2026-11-06T05:01:06Z",
"tithi_end_utc": "2026-11-07T05:18:21Z",
"tithi_start_unix": 1793941266,
"tithi_end_unix": 1794028701,
"sunset_utc": "2026-11-06T12:02:36Z",
"sunset_unix": 1793966556,
"pradosh_kaal_end_utc": "2026-11-06T14:39:33Z",
"pradosh_kaal_end_unix": 1793975973,
"pradosh_kaal_duration_minutes": 157,
"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": "22/11/2026",
"weekday": "Sunday",
"paksha": "Shukla",
"tithi_number": 13,
"tithi_start_utc": "2026-11-21T23:26:57Z",
"tithi_end_utc": "2026-11-22T21:07:34Z",
"tithi_start_unix": 1795303617,
"tithi_end_unix": 1795381654,
"sunset_utc": "2026-11-22T11:55:05Z",
"sunset_unix": 1795348505,
"pradosh_kaal_end_utc": "2026-11-22T14:36:03Z",
"pradosh_kaal_end_unix": 1795358163,
"pradosh_kaal_duration_minutes": 161,
"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"
}
],
"units": {
"time_unix": "seconds since 1970-01-01 UTC",
"duration_and_overlap": "minutes",
"tithi_numbering": "1 to 30; Shukla Trayodashi = 13, Krishna Trayodashi = 28",
"sun_limb": "upper_limb",
"atpress": "1013.25 hPa",
"attemp": "15 C",
"pradosh_kaal": "sunset to sunset plus one fifth of the night (sunset to next sunrise); this is the convention used here and is not universal"
}
},
"remaining_api_calls": 4998
}