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
Argentinaar3017493
Australiaau972049512
Austriaat271382
Azerbaijanaz353013
Bangladeshbd514344
Belarusby2691212
Belgiumbe18124
Boliviabo2411933
Bosnia and Herzegovinaba301976
Brazilbr211563
Bulgariabg241443
Canadaca10420138493
Chilecl2115243
Chinacn5327163
Colombiaco38201453
Congo Dem.Rep.cd211073
Costa Ricacr2391033
Croatiahr14143
Cubacu2210623
Czech Republiccz221483
Denmarkdk231163
Dominican Republicdo1912323
Ecuadorec2311553
Egypteg281953
El Salvadorsv28131173
Equatorial Guineagq1810453
Estoniaee12123
Ethiopiaet17133
Finlandfi1713414
Francefr191163
Georgiage251833
Germanyde3917152
Greecegr161333
Guatemalagt2010683
Hondurashn26121043
Hong Konghk221713
Hungaryhu141223
Icelandis251653
Indiain644741373
Indonesiaid272033
Iranir31272
Irelandie13943
Israelil3914196394
Italyit191223
Japanjp211743
Jordanjo18863
Kazakhstankz262113
Latvialv301843
Lithuanialt271383
Luxembourglu1510533
Macedonia, Republic ofmk4327104
Malaysiamy272433
Mexicomx441291973
Moldovamd44161623
Netherlandsnl141043
New Zealandnz10102
Nicaraguani209733
Nigeriang221252
Norwayno3521544
Pakistanpk41333193
Panamapa2721253
Paraguaypy18123
Perupe27131053
Philippinesph3123413
Polandpl201373
Portugalpt18933
Romaniaro2512133
Russiaru322633
Saudi Arabiasa271942
Serbiars1711644
Singaporesg33118105
Slovakiask3216163
Sloveniasi171433
South Africaza241464
South Koreakr221663
Spaines581373
Swedense2913553
Switzerlandch271785
Taiwantw481410203
Thailandth3320633
Turkeytr211342
Ukraineua4218154
United Arab Emiratesae181313
United Kingdomuk83849461
United Statesus35410853516
Uruguayuy2651513
Venezuelave39201563
Vietnamvn2514343

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

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