How to hit the Nager.Date API

Nager.Date at https://date.nager.at/api/v3 lists public holidays by country and year, including regional ones.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://date.nager.at/Api

Public holidays for a year

Country is an ISO 3166 two-letter code.

curl https://date.nager.at/api/v3/PublicHolidays/2026/US
Run in PostTaco
Example response (trimmed) 
[
  {
    "date": "2026-01-01",
    "localName": "New Year's Day",
    "name": "New Year's Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
  },
  {
    "date": "2026-01-19",
    "localName": "Martin Luther King, Jr. Day",
    "name": "Martin Luther King, Jr. Day",
    "countryCode": "US",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public",
      "Bank"
    ]
  }
]

Next holidays worldwide

Holidays in the coming week, across all countries.

curl https://date.nager.at/api/v3/NextPublicHolidaysWorldwide
Run in PostTaco
Example response (trimmed) 
[
  {
    "date": "2026-09-23",
    "localName": "秋分の日",
    "name": "Autumnal Equinox Day",
    "countryCode": "JP",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Public"
    ]
  },
  {
    "date": "2026-09-23",
    "localName": "dan slovenskega športa",
    "name": "Slovenian Sports Day",
    "countryCode": "SI",
    "fixed": false,
    "global": true,
    "counties": null,
    "launchYear": null,
    "types": [
      "Observance"
    ]
  }
]

Supported countries

curl https://date.nager.at/api/v3/AvailableCountries
Run in PostTaco
Example response (trimmed) 
[
  {
    "countryCode": "AD",
    "name": "Andorra"
  },
  {
    "countryCode": "AG",
    "name": "Antigua and Barbuda"
  }
]