Nager.Date

Overview

Nager.Date serves public holidays for 90+ countries as JSON — free, keyless, and updated yearly. A practical building block for holiday calendars, business-day calculations, and “is today a holiday?” features.

Quick Start

Public holidays for a country and year (verified live — US 2026):

curl "https://date.nager.at/api/v3/PublicHolidays/2026/US"

[
  {
    "date": "2026-01-01",
    "localName": "New Year's Day",
    "name": "New Year's Day",
    "countryCode": "US",
    "fixed": true,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": ["Public"]
  }
]

Today’s holidays for a country:

curl "https://date.nager.at/api/v3/Today/US"

Next public holidays:

curl "https://date.nager.at/api/v3/NextPublicHolidays/US"

Long weekends for a year:

curl "https://date.nager.at/api/v3/LongWeekend/2026/US"

Supported countries:

curl "https://date.nager.at/api/v3/AvailableCountries"

Authentication

None — keyless.

Rate Limits & Notes

• Free; no hard documented limit — be polite.
• Country codes are ISO 3166-1 alpha-2 (US, DE, CN…).
• Holiday entries include localName (local language), name (English), fixed, global (nationwide vs regional), counties, and types.
• Data is community-curated and updated annually — verify unusual cases.

FAQ

Is Nager.Date free? Yes — free and keyless.

Which countries are supported? 90+ countries (ISO alpha-2 codes).

How do I get holidays for a specific country? /api/v3/PublicHolidays/{year}/{countryCode}.