Public holidays for 100+ countries by year and ISO country code. Upcoming holiday lookup included. Free, no key required.
https://api.apiclearinghouse.com/v1/call/public-holidaysAuthenticate with X-Api-Key: chk_live_... header.
/holidays| Name | Type | Required | Description |
|---|---|---|---|
| year | number | required | Year (e.g. 2024) |
| countryCode | string | required | ISO 3166-1 alpha-2 country code (e.g. "US", "GB", "DE") |
curl -s "https://api.apiclearinghouse.com/v1/call/public-holidays/holidays?year={year}&countryCode={countryCode}" \
-H "X-Api-Key: YOUR_API_KEY"{
"status": "success",
"data": {
"holidays": "abc123"
}
}/next| Name | Type | Required | Description |
|---|---|---|---|
| countryCode | string | required | ISO 3166-1 alpha-2 country code (e.g. "US", "GB") |
curl -s "https://api.apiclearinghouse.com/v1/call/public-holidays/next?countryCode={countryCode}" \
-H "X-Api-Key: YOUR_API_KEY"{
"status": "success",
"data": {
"upcoming": "example"
}
}No setup required. Sign in and run Public Holidays directly from your browser.
Open in Explorer →Monthly limits also apply per plan.