List public holidays for a country and year
get_holidaysRead-onlyIdempotent
List the public (and optionally bank/observance) holidays for one country (and region) in one year, 2020-2035, with local names, types and official source links. Read-only. Same data, cache and limits as GET /v1/holidays.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Year, 2020-2035. | |
| types | No | Optional comma list of public, bank, observance, or "all" (default: all). | |
| region | No | Optional region/state code for countries with regional holidays, e.g. DE-BY, US-CA (or just BY). | |
| country | Yes | ISO 3166-1 alpha-2 country code, e.g. US, DE, GB. See list_countries. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| count | Yes | ||
| notes | No | ||
| scope | No | ||
| region | No | ||
| country | Yes | ||
| sources | No | ||
| holidays | Yes | ||
| region_name | No | ||
| country_name | No | ||
| data_version | No |