Public Holidays API - 150+ countries and their states/regions
public_holidaysOfficial public holidays for a country (and state/province/region) for any year 1950-2100: date, name, weekday. Local-language names where available (language=de, fr, bg...). Maintained open-source holiday rules, no outside call, < 50 ms. Free: 25 calls/day per IP. Paid: $0.001 per call via x402 at https://radarbg.com/x402/public-holidays.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": 2026,
"country": "DE",
"subdivision": "BY"
},
"name": "public_holidays"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year, default this year | |
| country | Yes | ISO 3166 alpha-2 code, e.g. DE, BG, US, GB | |
| language | No | Name language, e.g. en, de, fr (if the country has it) | |
| subdivision | No | State/region code, e.g. BY (Bavaria), CA (California) |