Public Holidays
## Global Public Holidays Get public holiday data for 20 major countries — dates, names, local names, and holiday types. Covering 2024 through 2030, with sub-100ms response times. ## Key Features - **20 countries** — US, UK, Canada, Australia, Germany, France, Japan, India, Brazil, and 11 more - **7-year range** — 2024 through 2030 with Easter-relative calculations - **Multiple holiday types** —…
Public Holidays endpoints
| Method | Endpoint | Description |
|---|---|---|
| Holidays | ||
| GET |
getNextHoliday /next |
Returns the next upcoming public holiday for the given country, including how many days until it occurs. |
| GET |
getHolidays /{year}/{countryCode} |
Returns all public holidays for the given country and year. Optionally filter by holiday type. |
| Metadata | ||
| GET |
getHealth /health |
Returns service health status. No authentication required. |
| GET |
getCountries /countries |
Returns all supported countries with their country code, name, total holiday count, and supported year range. |
Public Holidays pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9.99 / month | — |
|
| ULTRA | $29.99 / month | — |
|