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 No Rate Limits

Browser ready CORS Enabled

Quick Start Example

Fetch public holidays for a specific year and country:

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

Parameters

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

Response Model

date

string

The date of the holiday.

localName

string

Name in the native language.

name

string

Common English name.

counties

array

List of SubdivisionCodes

global

bool

Is National Holiday

launchYear

number

Deprecated field.

fixed

bool

Deprecated field.

types

array

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.