Nager.Date API

Nager.Date API is a free and open REST API that offers accurate public holiday data and calendar information for various countries. It’s designed for developers creating scheduling, calendar, or holiday reminder apps, helping users plan events with official holiday dates easily accessible programmatically.

Endpoints

Views

Jul 20, 2025

Last Checked

10,000 requests/day

Rate Limit

API Endpoints

Lists public holidays for a country/year

Full URL

https://date.nager.at/api/v3/PublicHolidays/{year}/{countryCode}

Code Examples

curl -X GET 'https://date.nager.at/api/v3/PublicHolidays/{year}/{countryCode}'

Parameters

{
  "year": 2023,
  "countryCode": "US"
}

Example Response

[
  {
    "date": "2023-01-01",
    "name": "New Year's Day",
    "localName": "New Year's Day"
  }
]

Version

v3