Nager.Date
VerifiedRetrieve public holidays for more than 90 countries through a simple API.
What is Nager.Date?
Nager.Date is a REST API that returns lists of public holidays for selected countries and years.
It supports calendar apps, HR systems, and scheduling tools that must adjust for regional holidays.
What you can build with Nager.Date
Global Team Scheduler
Automatically exclude public holidays when suggesting meeting times across teams in different countries.
HR Leave Calculator
Compute accurate working days and paid leave balances using country-specific holiday lists.
Travel Planning Tool
Show upcoming local holidays to users booking trips so they can avoid closures and crowds.
Get started with Nager.Date
- 1Visit the official Nager.Date GitHub or site to review the endpoint list
- 2Pick the target country using its ISO 3166-1 alpha-2 code
- 3Build a GET request to /api/v3/PublicHolidays/{year}/{countryCode}
- 4Send the HTTPS request from your code or tool of choice
- 5Parse the returned JSON array of holiday objects
Nager.Date: pros & cons
Pros
- +No API key or authentication required
- +Covers more than 90 countries
- +Simple HTTPS JSON endpoints
- +Free for any usage volume
Cons
- –Holiday data quality relies on community updates
- –Only returns fixed public holidays, no custom observances
- –No built-in support for subdivisions or states
Frequently asked questions
A free public API that returns lists of public holidays for over 90 countries.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…
Similar APIs
Other developer tools options worth comparing.