Nager.DateNager.Date public-holiday API

GET/api/v4/Holidays/{countryCode}/{year}

List public holidays for a year

Returns public holidays for one country and year, including names, scope, subdivisions, and classifications.

Look up supported countries, country information, annual or upcoming public holidays, today's holiday status, and the service version. The complete Community API v4 has six read-only endpoints; commercial use requires active sponsorship.

Request

operationId: listHolidaysByYear
Server: https://nagerholidays.com
Authentication: None

Request parameters

`countryCode`

pathstringrequired

ISO 3166-1 alpha-2 country code.

US

`year`

pathintegerint32required

Gregorian year for the requested public holidays.

Responses

`200`

PublicHolidayV4Dtoapplication/json

Request succeeded.

Properties: countryCodedateholidayTypesnamenationalHolidaysubdivisionCodes

`400`

ProblemDetailsapplication/json

Request parameters are invalid.

Properties: detailinstancestatustitletype

`404`

ProblemDetailsapplication/json

The requested country or resource was not found.

Properties: detailinstancestatustitletype

{
  "countryCode": "US",
  "date": "2026-01-01",
  "holidayTypes": "Public",
  "name": "New Year's Day",
  "nationalHoliday": true,
  "subdivisionCodes": [
    "subdivisionCodes-example"
  ]
}