← World Public Holidays
calendar by fourzerotwo
Holidays in a year
Official public holidays for a country (or region provider, e.g. Germany/Bavaria) in a year.
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
Use it from an AI agent (MCP)
Add the server once, then ask for this data in plain English. The agent finds the endpoint with search_apis and runs it with call_api.
{
"mcpServers": {
"fourzerotwo": { "type": "http", "url": "https://fourzerotwo.si/mcp" }
}
}
# the call the agent makes
call_api {"tool": "holidays__year", "arguments": {"country":"DE","year":2026}}
More from World Public Holidays
- Holiday & business-day check — Is a date a public holiday or business day in a country; add N business days; next business day.
- Supported countries — Every country and regional provider supported.
Holiday rules via Yasumi (MIT licence). Calculations by fourzerotwo.