Global Holidays API
## Public Holidays for 249 Countries with Sub-National Support Public Holidays API returns holidays for any country and year, including state and province-level holidays. Pre-built data for 2020-2030 with live computation for any year up to 2100. Just pass a country code and year. ### 249 Countries, 637 Subdivisions Every ISO 3166-1 alpha-2 country is covered. 35 countries include…
2 subscribers
8.7/10 popularity
631 ms avg latency
100% success rate
7 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Global Holidays API endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
health_health_get /health |
Health check endpoint. |
| v1 | ||
| GET |
get_next_holidays_v1_holidays_next_get /v1/holidays/next |
Get upcoming holidays for a country. |
| GET |
get_holidays_today_v1_holidays_today_get /v1/holidays/today |
Check if today is a holiday in a given country. |
| GET |
get_countries_v1_countries_get /v1/countries |
List all supported countries. |
| GET |
get_subdivisions_v1_countries__code__subdivisions_get /v1/countries/{code}/subdivisions |
List subdivisions (states/provinces) for a country. |
| GET |
get_holidays_v1_holidays_get /v1/holidays |
Get holidays for a country and year. |
| Other endpoints | ||
| GET |
root__get / |
API root with links to documentation. |
Global Holidays API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / hour |
|
| PRO | $4.99 / month | 100 / minute |
|
| ULTRA | $14.99 / month | 500 / minute |
|
| MEGA | $49.99 / month | 1000 / minute |
|
