Home › APIs › Calculators & dates
Public Holidays API
The official public holidays of any country for any year.
Used by: Small businesses, HR and payroll, finance apps and everyday users.
Official 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.
Try it live, no sign-up
Run the example as is, or change the input. 5 own tries a day without a key.
Example request
curl -X POST https://radarbg.com/v1/public-holidays \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"country": "DE", "year": 2026, "subdivision": "BY"}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
country | string | ISO 3166 alpha-2 code, e.g. DE, BG, US, GB |
year | integer | Year, default this year |
subdivision | string | State/region code, e.g. BY (Bavaria), CA (California) |
language | string | Name language, e.g. en, de, fr (if the country has it) |
Price
Included in every plan: 500 calls a month free, then from €9 a month for 5,000 calls across all APIs. Pro, €29 for 25,000 calls, is the one we recommend.
Questions
What does the Public Holidays API do?
The official public holidays of any country for any year.
Where does the data come from?
Official 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.
How much does it cost?
500 calls a month are free with no card. Paid plans start at EUR 9 a month for 5,000 calls and include every API on Radar. Failed calls are not counted.
Can I use it without writing code?
Yes. Try it live on this page, use our free browser tools, or ask us to run it on your list as a service.