Nager.Date

API

Free public holidays API for 90+ countries

Overview

Nager.Date API offers RESTful access to public holiday data for over 90 countries. Key endpoints include /api/v3/NextPublicHolidays/{countryCode} (upcoming holidays), /api/v3/PublicHolidays/{year}/{countryCode} (annual holidays), and /api/v3/SupportedCountries (list of covered nations). Responses are JSON-formatted with details like date, name, local name, country code, and holiday type (public, bank, school). Ideal for integrating into calendar apps, HR systems, travel planners, or event tools to display, calculate, or automate workflows involving public holidays.

Example Integration (JavaScript)

script.js JS


fetch('https://date.nager.at')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful API
JSON responses
90+ countries coverage
No authentication required
Next public holidays endpoint
Annual public holidays endpoint
Supported countries list

Frequently Asked Questions

? Is Nager.Date free to use?

Yes, Nager.Date is completely free for both non-commercial and commercial use (please review the terms of service for any restrictions).

? Does it require an API Key?

No, authentication is not required—you can access all endpoints without an API key.

? What is the response format?

All API responses are in JSON format, including fields like date (ISO 8601), name, localName, countryCode, and type (e.g., public, bank, school holiday).

Top Alternatives

Holiday API Search Google

Calendarific Compare

Google Calendar API (Holiday Calendars) Search Google

Tool Info

Pricing Free

Category Calendar

Platform Public API

Pros

⊕ No API key needed
⊕ Extensive country coverage
⊕ Simple, intuitive endpoints
⊕ Well-maintained documentation
⊕ Regular data updates

Cons

⊖ Rate-limited for high-volume requests
⊖ Some countries have limited historical data
⊖ No official SLA for enterprise use