x402

Holiday Calendar (x402)

Get public holidays by country and year for the 200+ countries covered by Nager.Date. Returns holiday names, dates, types (public/bank/optional), and whether they are fixed or variable.

get/x402/v2/holiday-calendar

Request

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

Query parameters

yearinteger

Year (default current year)

country_codestring required

ISO 2-letter country code

Response

Success

yearinteger

country_codestring

total_holidaysinteger

Example response

{
  "year": 2026,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Nyårsdagen"
    },
    {
      "date": "2026-01-06",
      "name": "Epiphany",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Trettondedag jul"
    },
    {
      "date": "2026-04-03",
      "name": "Good Friday",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Långfredagen"
    },
    {
      "date": "2026-04-05",
      "name": "Easter Sunday",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Påskdagen"
    },
    {
      "date": "2026-04-06",
      "name": "Easter Monday",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Annandag påsk"
    },
    {
      "date": "2026-05-01",
      "name": "International Workers' Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Första maj"
    },
    {
      "date": "2026-05-14",
      "name": "Ascension Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Kristi himmelsfärdsdag"
    },
    {
      "date": "2026-05-24",
      "name": "Pentecost",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Pingstdagen"
    },
    {
      "date": "2026-06-06",
      "name": "National Day of Sweden",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Sveriges nationaldag"
    },
    {
      "date": "2026-06-19",
      "name": "Midsummer Eve",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Midsommarafton"
    },
    {
      "date": "2026-06-20",
      "name": "Midsummer Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Midsommardagen"
    },
    {
      "date": "2026-10-31",
      "name": "All Saints' Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Alla helgons dag"
    },
    {
      "date": "2026-12-24",
      "name": "Christmas Eve",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Julafton"
    },
    {
      "date": "2026-12-25",
      "name": "Christmas Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Juldagen"
    },
    {
      "date": "2026-12-26",
      "name": "St. Stephen's Day",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Annandag jul"
    },
    {
      "date": "2026-12-31",
      "name": "New Year's Eve",
      "type": "Public",
      "fixed": false,
      "global": true,
      "counties": null,
      "local_name": "Nyårsafton"
    }
  ],
  "country_code": "SE",
  "total_holidays": 16
}

Changes

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