Public Holiday API

Access holiday data for over 100 countries with a simple, reliable JSON API. Perfect for business logic, scheduling, and global applications.

API Documentation GitHub Project

100+ Countries Global coverage

No Rate Limits Unlimited queries

CORS Enabled Browser ready

Quick Start Example

Fetch public holidays for a specific year and country:

GET /api/v3/PublicHolidays/{Year}/{CountryCode}

https://date.nager.at/api/v3/publicholidays/2026/AT

Parameters

Parameter	Required	Example	Description
`Year`		2026	The calendar year
`CountryCode`		AT	ISO 3166-1 alpha-2 code

Response Model

datestring

The date of the holiday.

localNamestring

Name in the native language.

namestring

Common English name.

countiesarray

List of SubdivisionCodes

globalbool

Is National Holiday

~~launchYearnumber~~

Deprecated field.

~~fixedbool~~

Deprecated field.

typesarray

Possible values: Public, Bank, School, Authorities, Optional, Observance.

JSON Preview

[
    {
        "date": "2026-01-01",
        "localName": "Neujahr",
        "name": "New Year's Day",
        "countryCode": "AT",
        "global": true,
        "counties": null,
        "launchYear": 1967,
        "types": ["Public"]
    },
    {
        "date": "2026-01-06",
        "localName": "Heilige Drei Könige",
        "name": "Epiphany",
        "countryCode": "AT",
        "global": true,
        "counties": null,
        "launchYear": null,
        "types": ["Public"]
    }
]

Community & Support

Nager.Date is an open-source project. If you find a bug or have a feature request, please open an issue on GitHub.

Report Issue

Legal Information

By using this API, you agree to our terms. Please review our policies regarding data usage and service availability.