Astrology

Hindu festival and vrat calendar

Hindu festivals, vrats, sankrantis, eclipses and periods for a year at a location. Each lunar festival is fixed by its lunar month (amanta, with Adhik months detected from new moons and sankrantis), its tithi, and the part of the day in which the tithi must prevail (sunrise, forenoon, Madhyahna, Aparahna, Pradosh, Nishita, moonrise), with the classical tie-breaks when a tithi spans two days, Bhadra rules for Holika Dahan and Raksha Bandhan, and the Smarta Ekadashi rule. Categories: festival (about 50 named festivals), vrat (every Ekadashi, Pradosh, Sankashti Chaturthi, Masik Shivaratri, Purnima, the Purnima vrat (fast) day and Amavasya), sankranti (12 solar ingresses), eclipse (with local visibility and contact times), period (Adhik Maas, Chaturmas, Pitru Paksha, Navratri, Holashtak, Kharmas). By default only the named festivals are returned; pass categories for the rest. Lahiri ayanamsa.

get/v1/astro/panchanga/festivals

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/panchanga/festivals
  • Auth: HTTP bearer

Query parameters

yearinteger required

Calendar year

Example:2026
locationstring nullable

City name

Example:Mumbai
latitudenumber nullable

Latitude in decimal degrees, north positive. Use with longitude and timezone instead of location.

longitudenumber nullable

Longitude in decimal degrees, east positive. Use with latitude and timezone instead of location.

timezonestring nullable

IANA timezone

categoriesstring nullable

Comma-separated subset of festival, vrat, sankranti, eclipse, period. Default: festival (the named festivals). Pass e.g. 'festival,vrat,period' for Ekadashis, Pradosh, Sankashti, Purnima and Amavasya, Adhik Maas and Pitru Paksha, or 'eclipse' for eclipses.

Example:festival,vrat,period

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Changes

No recorded changes to this operation across all 2 revisions of this API.