Private BetaFound a bug or have feedback? Share it →

Public Holidays

Public holidays for 100+ countries by year and ISO country code. Upcoming holiday lookup included. Free, no key required.

Healthy
SchedulingNo upstream key required

Base URL

https://api.apiclearinghouse.com/v1/call/public-holidays

Authenticate with X-Api-Key: chk_live_... header.

GET/holidays

Parameters

NameTypeRequiredDescription
yearnumberrequiredYear (e.g. 2024)
countryCodestringrequiredISO 3166-1 alpha-2 country code (e.g. "US", "GB", "DE")

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/public-holidays/holidays?year={year}&countryCode={countryCode}" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "holidays": "abc123"
  }
}
GET/next

Parameters

NameTypeRequiredDescription
countryCodestringrequiredISO 3166-1 alpha-2 country code (e.g. "US", "GB")

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/public-holidays/next?countryCode={countryCode}" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "upcoming": "example"
  }
}

Try it live

No setup required. Sign in and run Public Holidays directly from your browser.

Open in Explorer →

Rate Limits

Free10/min
Pro100/min
Elite500/min

Monthly limits also apply per plan.

Authentication

Pass your API key in the request header:

X-Api-Key: chk_live_...
Join the beta
← Back to catalog
public-holidays API Documentation — API Clearinghouse