Holiday Service

Retrieve a list of public holidays and observances for all 70+ 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
Argentinaar33176103
Australiaau9817510502
Austriaat271472
Azerbaijanaz322613
Bangladeshbd574944
Belarusby30111412
Belgiumbe211234
Boliviabo2512933
Bosnia and Herzegovinaba322176
Brazilbr261663
Bulgariabg311873
Canadaca10620138493
Chilecl2216253
Chinacn5027193
Colombiaco38181653
Congo Dem.Rep.cd231273
Costa Ricacr2391033
Croatiahr18143
Cubacu2210623
Czech Republiccz261393
Denmarkdk231163
Dominican Republicdo1912323
Ecuadorec2714853
Egypteg302243
El Salvadorsv28131173
Equatorial Guineagq1810453
Estoniaee16123
Ethiopiaet18143
Finlandfi2113414
Francefr251163
Georgiage251833
Germanyde3917152
Greecegr201333
Guatemalagt2010683
Hondurashn26111143
Hong Konghk231813
Hungaryhu2414613
Icelandis251653
Indiain674641353
Indonesiaid272033
Iranir30262
Irelandie17943
Israelil4613218414
Italyit231223
Japanjp282043
Jordanjo231363
Kazakhstankz262113
Latvialv301683
Lithuanialt271383
Luxembourglu1912323
Macedonia, Republic ofmk4629114
Malaysiamy352833
Mexicomx441381983
Moldovamd42151923
Netherlandsnl2010513
New Zealandnz2512722
Nicaraguani229953
Nigeriang2412632
Norwayno3621544
Pakistanpk47393193
Panamapa2619353
Paraguaypy18123
Perupe27131053
Philippinesph3624813
Polandpl241373
Portugalpt181023
Romaniaro3013133
Russiaru2719133
Saudi Arabiasa301792
Serbiars2312754
Singaporesg35136125
Slovakiask361511613
Sloveniasi211433
South Africaza2713104
South Koreakr271763
Spaines631873
Swedense2913553
Switzerlandch311985
Taiwantw562210203
Thailandth3724543
Turkeytr221352
Ukraineua4318194
United Arab Emiratesae191413
United Kingdomuk85979471
United Statesus37611952526
Uruguayuy2516333
Venezuelave37221163
Vietnamvn3117643

Total number of countries: 89, total number of holidays: 3162

Sample Data

{
  "version": 1,
  "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-01T00:00:00",
      "datetime": {
        "year": 2011,
        "month": 1,
        "day": 1,
        "hour": 0,
        "minute": 0,
        "second": 0
      }
    },
    "uid": "0007d600000007db",
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<data version="1">
  <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-01T00:00:00">
        <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>

Related Links

Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com