Calendar API Logo
Calendar API

Indian public holidays API

Official gazetted and restricted holidays for the Central Government and all 36 States and Union Territories, as JSON. No API key, no sign-up.

Try it in the playgroundRead the docs
Example request
# Copy and execute directly in your terminal
curl -s "https://calendar-api-d7a8.onrender.com/v1/holidays?country=IN&year=2026&region=KA"

Tip: Click "Run Request" above to execute inside the browser.

Endpoints

All endpoints are GET requests and need country=IN.

Full reference
  • /v1/holidaysAll holidays in a year, for the Central Government or one statecountry, year, region, scope
  • /v1/date/is-holidayWhether a date is a holiday, and which holidays fall on itcountry, date, region, scope
  • /v1/date/next-holidayThe next holiday after a given datecountry, date, region, scope
  • /v1/holidays/rangeHolidays between two dates, up to 5 calendar yearscountry, start, end, region, scope
  • /v1/calendarEvery day of a year with weekend, holiday and working-day flagscountry, year, region, scope, restricted

Data and source code: github.com/shrinivas-sn/calendar-api

Guides

Gazetted vs restricted holidays, HR leave calculations, and code examples in Node.js, Python and Go.

Read the guides