Nager.DateNager.Date public-holiday API

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

List upcoming public holidays

Returns a country's public holidays in the next 365 days; the upstream service returns 204 when none are available.

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: listUpcomingHolidays
Server: https://nagerholidays.com
Authentication: None

Request parameters

`countryCode`

pathstringrequired

ISO 3166-1 alpha-2 country code.

US

Responses

`200`

PublicHolidayV4Dtoapplication/json

Request succeeded.

Properties: countryCodedateholidayTypesnamenationalHolidaysubdivisionCodes

`204`

unknownapplication/json

Request succeeded.

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