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
Armeniaam34171034
Australiaau9917511502
Austriaat271472
Azerbaijanaz322613
Bangladeshbd574944
Barbadosbb241282
Belarusby30111412
Belgiumbe211234
Bermudabm251272
Boliviabo2512933
Bosnia and Herzegovinaba322176
Brazilbr281683
Bulgariabg311873
Canadaca10620138493
Cayman Islandsky231272
Chilecl2216253
Chinacn5027193
Colombiaco38181653
Congo Dem.Rep.cd231273
Costa Ricacr2391033
Cote d'Ivoireci19153
Croatiahr18143
Cubacu2210623
Cypruscy2515414
Czech Republiccz261393
Denmarkdk231163
Dominican Republicdo2112523
Ecuadorec2714853
Egypteg302243
El Salvadorsv28131173
Equatorial Guineagq1810453
Estoniaee16123
Ethiopiaet18143
Finlandfi2113414
Francefr251163
Georgiage251833
Germanyde3917152
Ghanagh2314532
Gibraltargi2613343
Greecegr211433
Guatemalagt2010683
Haitiht23964
Holy See (Vatican City)va261643
Hondurashn26111143
Hong Konghk231813
Hungaryhu2414613
Icelandis251653
Indiain674641353
Indonesiaid272033
Iranir30262
Iraqiq231713
Irelandie181043
Israelil4612228414
Italyit231223
Jamaicajm211073
Japanjp282043
Jordanjo231363
Kazakhstankz262113
Kenyake1811323
Kuwaitkw191413
Latvialv301683
Lebanonlb291494
Libyaly19694
Liechtensteinli302042
Lithuanialt271383
Luxembourglu1912323
Macedonia, Republic ofmk4629114
Malaysiamy352833
Maltamt191633
Mexicomx441381983
Moldovamd42151923
Monacomc261463
Montenegrome191323
Moroccoma21174
Netherlandsnl209523
New Zealandnz2512722
Nicaraguani229953
Nigeriang2412632
Norwayno3621544
Pakistanpk47393193
Panamapa2619353
Paraguaypy18123
Perupe27131053
Philippinesph3624813
Polandpl241373
Portugalpt181023
Puerto Ricopr271943
Qatarqa151013
Romaniaro3013133
Russiaru2719133
San Marinosm281933
Saudi Arabiasa301792
Serbiars2312754
Singaporesg35136125
Slovakiask361511613
Sloveniasi211433
South Africaza2713104
South Koreakr271763
Spaines631873
Sri Lankalk362753
Swedense2913553
Switzerlandch311985
Taiwantw562210203
Tanzaniatz2317223
Thailandth3724543
The Bahamasbs261372
Trinidad and Tobagott261664
Tunisiatn171214
Turkeytr221353
Ukraineua4318194
United Arab Emiratesae191413
United Kingdomuk86979471
United Statesus37611952526
Uruguayuy2516333
Venezuelave37221163
Vietnamvn3117643

Total number of countries: 120, total number of holidays: 3905

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>
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com