Indian Public Holidays & Calendar REST API
Free, keyless REST API serving official Gazetted and Restricted holiday schedules for the Central Government plus all 36 States and Union Territories.
curl -s "https://calendar-api-d7a8.onrender.com/v1/holidays?country=IN&year=2026®ion=KA"
Tip: Click "Run Request" above to execute inside the browser.
API Endpoint Matrix
5 lightweight endpoints tailored for leave calculations, calendar renderers, and HRMS validation.
List all gazetted & restricted holidays for Central Government or a specific State/UT.
Instant boolean check whether a specific calendar date is a public holiday in a given region.
Returns the immediate upcoming public holiday from today or an arbitrary reference date.
Query all holiday events falling between two calendar dates (start and end bounds).
Month-by-month structured calendar matrix with total working day counts.
Need raw datasets or offline ICS files? Access raw files directly in the repository.
Architecture, Compliance Rules & Integration Recipes
Read in-depth articles on Central vs State gazette rules, HRMS sandwich leave calculations, and multi-language SDK examples.