API reference/Time & Calendars/Public Holidays

Public Holidays

freeLive data

All public holidays for a country and year.

GET/api/v1/time/holidays

Data source

Query parameters

ParameterDescriptionTry value
country
string required
ISO code
year
number
Year (default current)
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.