Holiday API

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

API Documentation GitHub Project

150+ Countries Global coverage

No Rate Limits No Rate Limits

Browser ready CORS Enabled

Quick Start Example

Fetch public holidays for a specific year and country:

GET /api/v4/Holidays/{CountryCode}/{Year}

Parameters

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

Response Model

date

string

The date of the holiday.

name

string

Common English name.

countryCode

string

ISO 3166-1 alpha-2 country code

subdivisionCodes

array

List of SubdivisionCodes

nationalHoliday

bool

Is a National Holiday

holidayTypes

array

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

JSON Preview

[
    {
        "date": "2026-01-01",
        "name": "New Year's Day",
        "countryCode": "AT",
        "nationalHoliday": true,
        "subdivisionCodes": null,
        "holidayTypes": ["Public"]
    },
    {
        "date": "2026-01-06",
        "name": "Epiphany",
        "countryCode": "AT",
        "nationalHoliday": true,
        "subdivisionCodes": null,
        "holidayTypes": ["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.