List holidays
Tool ID: holidaycalendar_holidays_list
Summary
Lists holidays for one country in one calendar year. You can limit the list to a state or province, to nationwide days, or to a kind of holiday.
When to use it
- You want every public holiday in a country for a year.
- You want the holidays that apply in one state, province, or canton.
- You want school holidays or observances as well as public holidays.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Extra service login | No |
Parameters
| Parameter | Required? | Description |
|---|---|---|
country_code |
Yes | Two-letter country code, such as DE. |
year |
No | Four-digit year. Leave it out for the current UTC year. The service currently covers the previous calendar year through five years ahead. |
subdivision_code |
No | Region code such as DE-BY or US-CA. Nationwide holidays stay in the list, plus holidays for that region. |
holiday_types |
No | Kind of holiday. Leave it out for public holidays only. Ask for all types when you also want bank, school, authorities, optional, or observance days. |
national_only |
No | Set this when you want days that apply to the whole country and want regional-only days left out. |
What you get back
The country, year, filters you used, a count, and the holidays. Each holiday has a date, an English name, whether it is nationwide, the region codes when it is not, and the holiday types.
Example prompts
What are the public holidays in Germany in 2026?
List public holidays in Bavaria for 2026.
Show every kind of holiday in the United States this year, including observances.
Which US holidays in 2026 apply to the whole country?
Tips
- Holiday names are in English.
- A regional code must belong to the country.
DE-BYgoes withDE. - For “what is coming up” without naming a year, use Upcoming holidays.