← All endpoints / Panchang

Pradosh Vrat (Monthly)

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

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

Parameters

NameInRequiredTypeDescription
api_keyqueryYesstringYour VedIntel™ AstroAPI key. Get one at https://vedintelastroapi.com/auth/signupe.g. vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
monthqueryNointegerMonth (1–12). Defaults to current month.
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?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"

Example Response

{
  "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
}
← Back to all endpointsInteractive Docs
Get a free API key →