Skip to content
onelayer.
All tools

Tool detail

Holiday Calendar API

Checks whether a given ISO date is an official public holiday in a supported country or subdivision.

Categories: Utilities

Use when

  • check if a date is a public holiday in a country
  • verify a holiday before scheduling a payment or delivery
  • check a regional holiday, e.g. a German state

Not for

  • not a full year's holiday list (see the /list endpoint)
  • not business-day counting or date math (separate endpoints)

Inputs

GET query params: country (ISO 3166-1 alpha-2, one of 36 supported, required), date (ISO date, required); optional: language (2-letter), subdivision (e.g. DE-BE)

Inputs undocumented: enum larger than 32 values

Endpoint

Method
GET
URL
https://holidays.use.x402atlas.com/check

Payment

Protocol
x402
Listed price
0.005 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

Record
GET https://holidays.use.x402atlas.com/check
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z