The festivals-by-date API helps you find the festivals and other important events observed on a specific date for a given location. It takes the date, time, latitude, longitude, and timezone as input and returns the festivals and events applicable to that location and day.
The response includes the festival or event names along with the total number of results found for the requested date. This makes the API useful for applications that need to display daily festival information, build Panchang or calendar features, or show upcoming cultural and religious events based on the user's location.
https://json.astrologyapi.com/v1/festivals-by-datex-astrologyapi-keystringrequiredAPI access token used to authenticate requests. Send your access token in this custom header.
Accept-LanguagestringPreferred language for the response content. Supported: English - en.
dayintrequiredDay for which festivals are requested, eg: 30
monthintrequiredMonth for which festivals are requested, eg: 8
yearintrequiredYear for which festivals are requested, eg: 2026
hourintrequiredHour, eg: 19
minintrequiredMinute, eg: 55
latfloatrequiredLatitude, eg: 19.2056
lonfloatrequiredLongitude, eg: 25.2056
tzonefloatrequiredTimezone, eg: 5.5
curl --location 'https://json.astrologyapi.com/v1/festivals-by-date' \
--header 'Content-Type: application/json' \
--header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
--data '{
"day": 30,
"month": 8,
"year": 2026,
"hour": 19,
"min": 55,
"lat": 19.2056,
"lon": 25.2056,
"tzone": 5.5
}'
Runs with sample data — no API key needed
{
"date": "30-8-2026",
"count": 3,
"festivals": [
"2nd Chaturmasa Day 6",
"2nd Chaturmasa Day 7",
"Kajari Teej"
],
"msg": "3 festival/events found for this date"
}