x402

Public Holiday Lookup (x402)

Get public holidays by country and year for the 200+ countries covered by Nager.Date. Returns holiday dates, names, and next upcoming.

get/x402/v2/public-holiday-lookup

Request

Base URL: https://api.strale.io
URL: https://api.strale.io/x402/v2/public-holiday-lookup
Auth: none required

Query parameters

yearnumber

country_codestring required

Response

Success

next_upcomingobject

total_holidaysnumber

Example response

{
  "year": 2025,
  "holidays": [
    {
      "date": "2025-01-01",
      "name": "New Year's Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "New Year's Day"
    },
    {
      "date": "2025-01-20",
      "name": "Martin Luther King, Jr. Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Martin Luther King, Jr. Day"
    },
    {
      "date": "2025-02-12",
      "name": "Lincoln's Birthday",
      "type": "Observance",
      "fixed": false,
      "global": false,
      "local_name": "Lincoln's Birthday"
    },
    {
      "date": "2025-02-17",
      "name": "Presidents Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Washington's Birthday"
    },
    {
      "date": "2025-04-18",
      "name": "Good Friday",
      "type": "Public",
      "fixed": false,
      "global": false,
      "local_name": "Good Friday"
    },
    {
      "date": "2025-04-18",
      "name": "Good Friday",
      "type": "Optional",
      "fixed": false,
      "global": false,
      "local_name": "Good Friday"
    },
    {
      "date": "2025-05-08",
      "name": "Truman Day",
      "type": "School, Authorities",
      "fixed": false,
      "global": false,
      "local_name": "Truman Day"
    },
    {
      "date": "2025-05-26",
      "name": "Memorial Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Memorial Day"
    },
    {
      "date": "2025-06-19",
      "name": "Juneteenth National Independence Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Juneteenth National Independence Day"
    },
    {
      "date": "2025-07-04",
      "name": "Independence Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Independence Day"
    },
    {
      "date": "2025-09-01",
      "name": "Labour Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Labor Day"
    },
    {
      "date": "2025-10-13",
      "name": "Columbus Day",
      "type": "Public",
      "fixed": false,
      "global": false,
      "local_name": "Columbus Day"
    },
    {
      "date": "2025-10-13",
      "name": "Indigenous Peoples' Day",
      "type": "Public",
      "fixed": false,
      "global": false,
      "local_name": "Indigenous Peoples' Day"
    },
    {
      "date": "2025-11-11",
      "name": "Veterans Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Veterans Day"
    },
    {
      "date": "2025-11-27",
      "name": "Thanksgiving Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Thanksgiving Day"
    },
    {
      "date": "2025-12-25",
      "name": "Christmas Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "local_name": "Christmas Day"
    }
  ],
  "country_code": "US",
  "next_upcoming": null,
  "total_holidays": 16
}

Changes

No recorded changes to this operation across all 1 revision of this API.