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
Australiaau961759492
Austriaat271472
Azerbaijanaz363113
Bangladeshbd554744
Belarusby2691212
Belgiumbe211234
Boliviabo2512933
Bosnia and Herzegovinaba312076
Brazilbr281683
Bulgariabg291763
Canadaca10419148483
Chilecl2216253
Chinacn5827223
Colombiaco39181753
Congo Dem.Rep.cd211073
Costa Ricacr2391033
Croatiahr18143
Cubacu2210623
Czech Republiccz261393
Denmarkdk231163
Dominican Republicdo1912323
Ecuadorec2311753
Egypteg312343
El Salvadorsv28131173
Equatorial Guineagq2012453
Estoniaee16123
Ethiopiaet17133
Finlandfi2113414
Francefr231163
Georgiage251833
Germanyde3917152
Greecegr201333
Guatemalagt2010683
Hondurashn26111143
Hong Konghk221713
Hungaryhu2011533
Icelandis251653
Indiain674641363
Indonesiaid292143
Iranir31272
Irelandie17943
Israelil4312216394
Italyit231223
Japanjp282043
Jordanjo251563
Kazakhstankz282313
Latvialv301683
Lithuanialt271383
Luxembourglu1912323
Macedonia, Republic ofmk4326114
Malaysiamy322353
Mexicomx441381983
Moldovamd45172023
Netherlandsnl199513
New Zealandnz2310722
Nicaraguani229953
Nigeriang2513632
Norwayno3621544
Pakistanpk47393193
Panamapa2720353
Paraguaypy18123
Perupe27131053
Philippinesph3023313
Polandpl241373
Portugalpt181023
Romaniaro2912133
Russiaru362633
Saudi Arabiasa349212
Serbiars2312754
Singaporesg38128145
Slovakiask361511613
Sloveniasi211433
South Africaza2914114
South Koreakr271763
Spaines581373
Swedense2913553
Switzerlandch311985
Taiwantw491411203
Thailandth3522543
Turkeytr211342
Ukraineua4419194
United Arab Emiratesae201153
United Kingdomuk83869461
United Statesus36910851516
Uruguayuy2713863
Venezuelave38241063
Vietnamvn3216843

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

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