Holiday API

Public Holidays and Observances for Developers

Today is Good Friday
To retrieve a list of holidays, simply make a GET request to /v1/holidays:
$ curl -G -d country="US" -d year="2019" -d month="04" -d day="19" "https://holidayapi.com/v1/holidays"

Trusted by Developers at World Class Organizations
Adobe Creative Artists Agency Fiverr JetPay Massachusetts Institute of Technology
Nielsen Slack SquareTrade Todoist
316,449,890 requests served to 18,789 happy customers.
Required Parameters
key
your API key
country
ISO 3166-2 format
year
ISO 8601 format
month
1 or 2 digit month (1-12)
day
1 or 2 digit day (1-31 depending on the month)
Optional Parameters
previous
boolean, return previous holidays based on the date
upcoming
boolean, return upcoming holidays based on the date
public
boolean, return only public holidays
format
string, data return format (csv, json [default], php, tsv, yaml and xml)
pretty
boolean, prettifies returned results
Supported Countries
Angola
Austria
Australia
Aruba
Åland Islands
Bosnia and Herzegovina
Belgium
Bulgaria
Bolivia
Brazil
The Bahamas
Canada
Switzerland
China
Colombia
Costa Rica
Cuba
Czech Republic
Germany
Denmark
Dominican Republic
Ecuador
Spain
Finland
France
Alsace
United Kingdom
England
Northern Ireland
Scotland
Wales
Ghana
Greece
Guatemala
Hong Kong
Honduras
Croatia
Hungary
Indonesia
Ireland
India
Israel
Iceland
Italy
Japan
Kazakhstan
Lesotho
Lithuania
Luxembourg
Madagascar
Martinique
Malta
Mauritius
Mexico
Mozambique
Nigeria
Netherlands
Norway
New Zealand
Auckland
Bay of Plenty
Canterbury
Gisborne
Hawke's Bay
Marlborough
Manawatu-Wanganui
Nelson
Northland
Otago
Southland
Tasman
Taranaki
Wellington
Waikato
West Coast
Peru
Pakistan
Philippines
Poland
Puerto Rico
Portugal
Paraguay
Réunion
Romania
Russia
Seychelles
Sweden
Singapore
Slovenia
Slovakia
Sierra Leone
Sao Tome and Principe
Tunisia
Turkey
Ukraine
United States
Uruguay
Venezuela
South Africa
Zimbabwe
Angola
Austria
Australia
Aruba
Åland Islands
Bosnia and Herzegovina
Belgium
Bulgaria
Bolivia
Brazil
The Bahamas
Canada
Switzerland
China
Colombia
Costa Rica
Cuba
Czech Republic
Germany
Denmark
Dominican Republic
Ecuador
Spain
Finland
France
Alsace
United Kingdom
England
Northern Ireland
Scotland
Wales
Ghana
Greece
Guatemala
Hong Kong
Honduras
Croatia
Hungary
Indonesia
Ireland
India
Israel
Iceland
Italy
Japan
Kazakhstan
Lesotho
Lithuania
Luxembourg
Madagascar
Martinique
Malta
Mauritius
Mexico
Mozambique
Nigeria
Netherlands
Norway
New Zealand
Auckland
Bay of Plenty
Canterbury
Gisborne
Hawke's Bay
Marlborough
Manawatu-Wanganui
Nelson
Northland
Otago
Southland
Tasman
Taranaki
Wellington
Waikato
West Coast
Peru
Pakistan
Philippines
Poland
Puerto Rico
Portugal
Paraguay
Réunion
Romania
Russia
Seychelles
Sweden
Singapore
Slovenia
Slovakia
Sierra Leone
Sao Tome and Principe
Tunisia
Turkey
Ukraine
United States
Uruguay
Venezuela
South Africa
Zimbabwe
Don’t see your country? Let us know!
Status Codes
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)
429
Rate limit exceeded
500
OH NOES!!~! Something is wrong on our end
Sample Response
{
  "status": 200,
  "holidays": [
    {
      "name": "Independence Day",
      "date": "2015-07-04"
      "observed": "2015-07-03"
      "public": true,
    }
  ]
}

Get Started in Minutes