Tool detail

2s

Lists official holidays for a country and year with exact observed dates, including substitute days for weekend holidays.

Categories: Utilities

Use when

get the public holidays for a country in a given year
find the observed or substitute date for a holiday on a weekend
filter holidays by type: public, bank, school, optional, observance

Not for

not a business-day calculator; see the business-days endpoint for date math

Inputs

GET query params: country, year (required); region, types, lang (optional)

Admitted input schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, JP."
    },
    "lang": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional ISO 639-1 language for holiday names."
    },
    "region": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional subdivision code, e.g. CA (US-California), BY (DE-Bavaria)."
    },
    "types": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional comma-separated filter: public, bank, school, optional, observance."
    },
    "year": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Calendar year, e.g. 2026."
    }
  },
  "required": [
    "country",
    "year"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://2s.io/api/calendar/holidays

Payment

Protocol: x402
Listed price: 0.0025 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://2s.io/api/calendar/holidays
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z