List public holidays
list_holidaysRead-onlyIdempotent
Use this when the user asks which public holidays (bank holidays) a country or a state/region has in a year, e.g. 'Poland public holidays 2026' or 'Texas state holidays 2027', usually to plan working days. Returns each holiday with date, weekday, English name and whether it falls on a weekend, including the observed weekday off when a holiday falls on a weekend, plus a CSV file. Does not include school holidays, religious observances that are not days off, or company-specific closures. Do not use to check whether a stock exchange is open.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year, e.g. 2026. Defaults to the current year. | |
| country | Yes | Country as an ISO two-letter code, e.g. PL, US, GB, DE. | |
| subdivision | No | Optional state/region code, e.g. TX (Texas), BY (Bavaria), SCT (Scotland). | |
| weekend_days | No | Weekend days used to flag holidays falling on a weekend, e.g. ["friday","saturday"]. Default from the country. | |
| include_bank_holidays | No | Also list bank-only closing days where available, e.g. Dec 24 in Germany. Default false. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| year | Yes | ||
| count | Yes | ||
| notes | Yes | ||
| inputs | Yes | ||
| region | Yes | ||
| summary | Yes | ||
| holidays | Yes | ||
| downloads | Yes | ||
| on_weekdays | Yes | ||
| weekend_days | Yes | ||
| observed_days | Yes |