Holiday Service

Retrieve a list of public holidays and observances for all 120+ countries in our database.

The service provides the following data:

  • Holiday name and date.
  • List of states or provinces within the country that observe the holiday (in case it is not observed in the whole country).
  • Type of holiday (flag day, local observance, religious day, …)
  • Short description of the holiday (some countries).
  • Link to timeanddate.com with further information about the day (some countries).

Available Countries

We constantly work on expanding our holiday database and add new countries on a regular basis. The table below shows the countries our service currently includes and the amount of holidays, observances and other events we offer for each country.

Click one of the table headers to sort the list by the amount of dates we offer for that category. Click a country name to see more details about this country. Click a number within the table to see a list of the available holidays in that category.

CountryIdTotal DaysState & Federal HolidaysCommon Obser­vancesMore Obser­vancesReligious daysLanguages
Albaniaal3214123
Algeriadz16124
Andorraad292214
Argentinaar33176103
Armeniaam36181034
Australiaau10119511502
Austriaat271472
Azerbaijanaz352913
Bangladeshbd574944
Barbadosbb241282
Belarusby30111412
Belgiumbe211234
Bermudabm251272
Boliviabo2714933
Bosnia and Herzegovinaba322176
Brazilbr281683
Bulgariabg311873
Canadaca10822138493
Cayman Islandsky231272
Chilecl2216253
Chinacn5128193
Colombiaco38181653
Congo Dem.Rep.cd231273
Costa Ricacr2391033
Cote d'Ivoireci19153
Croatiahr18143
Cubacu2210623
Cypruscy2515414
Czech Republiccz261393
Denmarkdk231163
Dominican Republicdo2112523
Ecuadorec2714853
Egypteg312343
El Salvadorsv30151173
Equatorial Guineagq1810453
Estoniaee16123
Ethiopiaet18143
Finlandfi2113414
Francefr251163
Georgiage251833
Germanyde3917152
Ghanagh2515632
Gibraltargi2613343
Greecegr221443
Guatemalagt2010683
Haitiht23964
Holy See (Vatican City)va261643
Hondurashn26111143
Hong Konghk241913
Hungaryhu2414613
Icelandis251653
Indiain684741353
Indonesiaid282133
Iranir30262
Iraqiq241813
Irelandie181043
Israelil4612228414
Italyit231223
Jamaicajm211073
Japanjp282043
Jordanjo261663
Kazakhstankz262113
Kenyake1811323
Kosovoxk281394
Kuwaitkw201513
Latvialv291583
Lebanonlb291494
Libyaly19694
Liechtensteinli302042
Lithuanialt271383
Luxembourglu1912323
Macedonia, Republic ofmk4629114
Malaysiamy352833
Maltamt191633
Mexicomx441381983
Moldovamd42151923
Monacomc261463
Montenegrome191323
Moroccoma25174
Netherlandsnl2010423
New Zealandnz2612822
Nicaraguani229953
Nigeriang2614632
Norwayno3921674
Pakistanpk48403193
Panamapa2619353
Paraguaypy20143
Perupe27131053
Philippinesph3624813
Polandpl241373
Portugalpt181023
Puerto Ricopr271943
Qatarqa231813
Romaniaro3013133
Russiaru2719133
San Marinosm281933
Saudi Arabiasa301792
Serbiars2312754
Singaporesg35136125
Slovakiask361511613
Sloveniasi221443
South Africaza2713104
South Koreakr271763
Spaines641873
Sri Lankalk362753
Swedense2913553
Switzerlandch311985
Taiwantw562210203
Tanzaniatz2417323
Thailandth3724543
The Bahamasbs261372
Trinidad and Tobagott261664
Tunisiatn171214
Turkeytr231363
Ukraineua4419194
United Arab Emiratesae231813
United Kingdomuk86969481
United Statesus37811957526
Uruguayuy2416333
Venezuelave37221163
Vietnamvn3117643

Total number of countries: 121, total number of holidays: 3989

Sample Data

{
  "version": 2,
  "holidays": [{
    "id": 2006,
    "urlid": "us/new-year-day",
    "url": "http://www.timeanddate.com/holidays/us/new-year-day",
    "country": {
      "id": "us",
      "name": "United States"
    },
    "name": "New Year's Day",
    "oneliner": "New Year's Day is the first day of the Gregorian calendar, which is widely used in many countries such as the USA.",
    "types": ["National holiday"],
    "date": {
      "iso": "2011-01-01",
      "datetime": {
        "year": 2011,
        "month": 1,
        "day": 1,
        "hour": 0,
        "minute": 0,
        "second": 0
      }
    },
    "uid": "0007d600000007db",
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<data version="2">
  <holidays>
    <holiday id="2006" urlid="us/new-year-day" url="http://www.timeanddate.com/holidays/us/new-year-day">
      <country id="us">United States</country>
      <name>New Year's Day</name>
      <oneliner>New Year's Day is the first day of the Gregorian calendar, which is widely used in many countries such as the USA.</oneliner>
      <types>
        <type>National holiday</type>
      </types>
      <date iso="2011-01-01">
        <datetime>
          <year>2011</year>
          <month>1</month>
          <day>1</day>
          <hour>00</hour>
          <minute>00</minute>
          <second>00</second>
        </datetime>
      </date>
      <uid>0007d600000007db</uid>
    </holiday>
  </holidays>
</data>
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//TIMEANDDATE AS//NONSGML//EN
BEGIN:VEVENT
DTSTAMP:20150320T080415Z
UID:0007d600000007db@timeanddate.com
DTSTART;VALUE=DATE:20110101
DTEND;VALUE=DATE:20110102
SUMMARY:New Year's Day
DESCRIPTION:New Year's Day is the first day of the Gregorian calendar\, whi
 ch is widely used in many countries such as the USA.\n\nRead more: http://
 www.timeanddate.com/holidays/us/new-year-day
LOCATION:United States
X-TAD-URL;VALUE=URI:http://www.timeanddate.com/holidays/us/new-year-day
X-TAD-TYPE;VALUE=TEXT:National holiday
X-TAD-COUNTRY;VALUE=TEXT:us
END:VEVENT
END:VCALENDAR
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com