Public Holidays
Comprehensive public holidays API covering 100+ countries. Retrieve public holidays for any country and year, check if today is a holiday, and list supported countries. Returns holiday names, dates, types, and observance details. Ideal for scheduling applications, HR systems, payroll software, travel planning, and calendar integrations. Data is sourced from official government publications and…
1 subscribers
16 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Public Holidays endpoints
| Method | Endpoint | Description |
|---|---|---|
| Holidays | ||
| GET |
getHolidays /v1/holidays |
Returns all public holidays for a given country and year. Each holiday includes the date, name, local name, type, and whether it is a fixed or movable holiday. Results are sorted… |
| GET |
getUpcomingHolidays /v1/upcoming |
Returns upcoming public holidays for a specified country within a given number of days from today. Default is 30 days. |
| GET |
checkDateHoliday /v1/check |
Checks whether a specific date is a public holiday in the specified country. Returns a boolean result along with holiday details if applicable, and the next upcoming holiday. |
| GET |
checkTodayHoliday /v1/today |
Checks whether today is a public holiday in the specified country. Returns a boolean result along with holiday details if applicable. Uses the server's UTC date by default, or… |
| Reference | ||
| GET |
listSupportedCountries /v1/countries |
Returns the complete list of countries for which holiday data is available. Each entry includes the country code, name, available year range, and total number of holidays for the… |
| Utility | ||
| GET |
getDocs /v1/docs |
Returns links to API documentation, changelog, and support resources. |
| GET |
getHealth /health |
Returns the current health status of the API. This endpoint requires no authentication and can be used for uptime monitoring. |
| GET |
getTiers /v1/tiers |
Returns the current user's tier and all available pricing tiers with their rate limits. |
| Other endpoints | ||
| GET |
listSupportedCountries /v1/countries |
Returns the complete list of countries for which holiday data is available. Each entry includes the country code, name, available year range, and total number of holidays for the… |
| GET |
checkDateHoliday /v1/check |
Checks whether a specific date is a public holiday in the specified country. Returns a boolean result along with holiday details if applicable, and the next upcoming holiday. |
| GET |
getHolidays /v1/holidays |
Returns all public holidays for a given country and year. Each holiday includes the date, name, local name, type, and whether it is a fixed or movable holiday. Results are sorted… |
| GET |
getDocs /v1/docs |
Returns links to API documentation, changelog, and support resources. |
| GET |
getTiers /v1/tiers |
Returns the current user's tier and all available pricing tiers with their rate limits. |
| GET |
getHealth /health |
Returns the current health status of the API. This endpoint requires no authentication and can be used for uptime monitoring. |
| GET |
getUpcomingHolidays /v1/upcoming |
Returns upcoming public holidays for a specified country within a given number of days from today. Default is 30 days. |
| GET |
checkTodayHoliday /v1/today |
Checks whether today is a public holiday in the specified country. Returns a boolean result along with holiday details if applicable. Uses the server's UTC date by default, or… |
Public Holidays pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / minute |
|
| PRO | $9.99 / month | 30 / minute |
|
| ULTRA Recommended | $49.99 / month | 150 / minute |
|
| MEGA | $199 / month | 500 / minute |
|
