APImcp
GuidesGeo & Network
ConsoleDocsMCP
Geo & Network ⏱ 1 min read

Holiday Calendar API — Get Public Holidays for Any Country and Year

Get public holidays for 100+ countries by year. Includes holiday name, date, type (public, bank, observance), and local language. Free API.

01

What is the Holiday Calendar API?

The holiday calendar API returns public holidays for any country and year. Each holiday entry includes the name, date, holiday type (public holiday, bank holiday, observance), local language name, and whether it's a nationwide holiday. Useful for workforce management, scheduling, and localization.

02

How to Use It

Call GET /api/v1/holidays?year=2026&country=NO. Returns { country: string, year: number, holidays: Array<{ name: string, date: string, type: string, local_name: string }>, count: number }.

Try it live Test this endpoint in the interactive console
Open Console →

Frequently Asked Questions

How many countries are supported?
Public holidays for 100+ countries are included in the database.