fourzerotwo
← 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

ParamTypeDescription
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 rules via Yasumi (MIT licence). Calculations by fourzerotwo.