Basic Usage
To retrieve a list of holidays, simply make a GET request to /v1/holidays
Required Parameters
Optional Parameters
key
your API key
country
ISO 3166-2 format
year
ISO 8601 format
key
your API key
country
ISO 3166-2 format
year
ISO 8601 format
Supported Countries
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Facere ea error fugit enim deleniti numquam mollitia, illum quos ex distinctio inventore architecto totam dolorem suscipit. Soluta impedit totam dolor est aperiam consequatur aut, a quos!
ID Idaho
ID Idaho
ID Idaho
ID Idaho
ID Idaho
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Error, dolore.
Status Codes
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Illum, vitae.
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Eius labore maxime exercitationem, voluptatem sequi quae.
200
Success! Everything is A-OK
400
Something is wrong on your end
401
Unauthorized (did you remember your API key?)
402
Payment required (only historical data available is free)
403
Forbidden (this API is HTTPS-only)d
429
Rate limit exceeded
500
OH NOES!!~! Something is wrong on our end
Rate Limits
Limits vary by plan, once exceeded the API will return the 429 status code.
Response
{
"status": 200,
"holidays": [{
"name": "Independence Day",
"date": "2015-07-04"
"observed": "2015-07-03"
"public": true,
}]
}