Calendarific
APIHolidays API for 230+ countries with national, local and religious holidays
- Access
- API key (api_key parameter)
About
Calendarific's REST API returns national, local, religious and observance holidays for 230+ countries and 3,300+ states and regions, filtered by year, month, day, location and type. The free plan has 500 calls a month with attribution and one language; paid plans drop the attribution.
What you can do with it
- List a country's national, local and religious holidays for a year
- Filter holidays by state or region code, such as a US state
- Show holiday names in local languages in a scheduling or HR app
Get started
- Sign up for a free API key
- Call /api/v2/holidays with a country code and a year
Example
curl "https://calendarific.com/api/v2/holidays?api_key=$CALENDARIFIC_API_KEY&country=TR&year=2026"Details
- Hosting
- Hosted service
- Available in
- Worldwide
- Official SDKs
- JavaScript/TypeScript, PHP, Python
- MCP server
- None