World Public Holidays
Computed from published holiday rules (Yasumi). For UK bank holidays the GOV.UK feed in uk-bank-holidays is authoritative.
- cost
- Free every endpoint, within the daily allowance
- after that
- from $0.0005 / call · card or USDC
- endpoints
- 3
No signup needed over MCP: 50 free calls a day, or 500 with a free key.
Holidays in a year Free
Official public holidays for a country (or region provider, e.g. Germany/Bavaria) in a year.
- cost
- Free then $0.001 / call
- MCP tool
- holidays__year
- method
- GET
Free up to 50 calls a day over MCP (500 with a free key), then $0.001 per call by card credit or USDC. Free key · Pay by card
GET https://fourzerotwo.si/v1/holidays/year
| Param | Type | Description |
|---|---|---|
| country | string | ISO code (US, DE, FR, JP…) or provider name |
| year? | integer | Year (default this year) |
# free: send a free key from https://fourzerotwo.si/free curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/holidays/year?country=DE" # no key: returns 402 with the price, for x402 agents curl -i "https://fourzerotwo.si/v1/holidays/year?country=DE"
by fourzerotwo
Report this endpoint
Holiday & business-day check Free
Is a date a public holiday or business day in a country; add N business days; next business day.
- cost
- Free then $0.001 / call
- MCP tool
- holidays__check
- method
- GET
Free up to 50 calls a day over MCP (500 with a free key), then $0.001 per call by card credit or USDC. Free key · Pay by card
GET https://fourzerotwo.si/v1/holidays/check
| Param | Type | Description |
|---|---|---|
| country | string | ISO code |
| date | string | YYYY-MM-DD |
| add? | integer | Business days to add |
# free: send a free key from https://fourzerotwo.si/free curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/holidays/check?country=US&date=2026-11-26" # no key: returns 402 with the price, for x402 agents curl -i "https://fourzerotwo.si/v1/holidays/check?country=US&date=2026-11-26"
by fourzerotwo
Report this endpoint
Supported countries Free
Every country and regional provider supported.
- cost
- Free then $0.0005 / call
- MCP tool
- holidays__countries
- method
- GET
Free up to 50 calls a day over MCP (500 with a free key), then $0.0005 per call by card credit or USDC. Free key · Pay by card
GET https://fourzerotwo.si/v1/holidays/countries
# free: send a free key from https://fourzerotwo.si/free curl -H "X-API-Key: fzt_…" "https://fourzerotwo.si/v1/holidays/countries" # no key: returns 402 with the price, for x402 agents curl -i "https://fourzerotwo.si/v1/holidays/countries"
by fourzerotwo
Report this endpoint
Holiday rules via Yasumi (MIT licence). Calculations by fourzerotwo.