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
Brazilbr241683
Bulgariabg281663
Canadaca10419148493
Chilecl2216253
Chinacn5227163
Colombiaco39181753
Congo Dem.Rep.cd211073
Costa Ricacr2391033
Croatiahr14143
Cubacu2210623
Czech Republiccz221393
Denmarkdk231163
Dominican Republicdo1912323
Ecuadorec2311553
Egypteg312343
El Salvadorsv28131173
Equatorial Guineagq2012453
Estoniaee12123
Ethiopiaet17133
Finlandfi1713414
Francefr191163
Georgiage251833
Germanyde3917152
Greecegr161333
Guatemalagt2010683
Hondurashn26111143
Hong Konghk221713
Hungaryhu1611533
Icelandis251653
Indiain634641363
Indonesiaid292143
Iranir31272
Irelandie13943
Israelil3912216394
Italyit191223
Japanjp212013
Jordanjo251563
Kazakhstankz282313
Latvialv301843
Lithuanialt271383
Luxembourglu1512323
Macedonia, Republic ofmk4326114
Malaysiamy282353
Mexicomx441291973
Moldovamd44161623
Netherlandsnl159513
New Zealandnz1910722
Nicaraguani229953
Nigeriang2513632
Norwayno3521544
Pakistanpk47393193
Panamapa2720353
Paraguaypy18123
Perupe27131053
Philippinesph3023313
Polandpl201373
Portugalpt181023
Romaniaro2512133
Russiaru322633
Saudi Arabiasa349212
Serbiars1912754
Singaporesg38128145
Slovakiask321511613
Sloveniasi171433
South Africaza2914114
South Koreakr231763
Spaines581373
Swedense2913553
Switzerlandch271985
Taiwantw491411203
Thailandth3522543
Turkeytr211342
Ukraineua4319154
United Arab Emiratesae171213
United Kingdomuk83869461
United Statesus36810851516
Uruguayuy2713863
Venezuelave38241063
Vietnamvn3116743

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

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