← All endpoints / Panchang

Pradosh Vrat (Yearly)

GET/api/v1/panchang/pradosh-vrat-year
GEThttps://vedintelastroapi.com/api/v1/panchang/pradosh-vrat-year

Returns 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.

Parameters

NameInRequiredTypeDescription
api_keyqueryYesstringYour VedIntel™ AstroAPI key. Get one at https://vedintelastroapi.com/auth/signupe.g. vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
yearqueryNointegerYear (e.g. 2026). Defaults to current year.
latqueryYesnumberBirth latitude with decimalse.g. 11
lonqueryYesnumberBirth longitude with decimalse.g. 77
tzqueryYesnumberTimezone offset from UTC. IST = 5.5e.g. 5.5
rulequeryNostring
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.

Example Request

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"

Example Response

{
  "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,
… response truncated for display. See the interactive docs for the full schema.
← Back to all endpointsInteractive Docs
Get a free API key →