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
Australiaau972049512
Austriaat271382
Azerbaijanaz353013
Bangladeshbd554744
Belarusby2691212
Belgiumbe18124
Boliviabo2411933
Bosnia and Herzegovinaba301976
Brazilbr231583
Bulgariabg281663
Canadaca10520148493
Chilecl2115243
Chinacn5627163
Colombiaco39201553
Congo Dem.Rep.cd211073
Costa Ricacr2391033
Croatiahr14143
Cubacu2210623
Czech Republiccz221483
Denmarkdk231163
Dominican Republicdo1912323
Ecuadorec2311553
Egypteg302153
El Salvadorsv28131173
Equatorial Guineagq1810453
Estoniaee12123
Ethiopiaet17133
Finlandfi1713414
Francefr191163
Georgiage251833
Germanyde3917152
Greecegr161333
Guatemalagt2010683
Hondurashn26121043
Hong Konghk221713
Hungaryhu141223
Icelandis251653
Indiain634641363
Indonesiaid282133
Iranir31272
Irelandie13943
Israelil3914196394
Italyit191223
Japanjp211743
Jordanjo18863
Kazakhstankz282313
Latvialv301843
Lithuanialt271383
Luxembourglu1510533
Macedonia, Republic ofmk4327104
Malaysiamy282443
Mexicomx441291973
Moldovamd44161623
Netherlandsnl13943
New Zealandnz1810712
Nicaraguani209733
Nigeriang241452
Norwayno3521544
Pakistanpk45373193
Panamapa2721253
Paraguaypy18123
Perupe27131053
Philippinesph3023313
Polandpl201373
Portugalpt18933
Romaniaro2512133
Russiaru322633
Saudi Arabiasa3216122
Serbiars1711644
Singaporesg38128145
Slovakiask3216163
Sloveniasi171433
South Africaza241464
South Koreakr221663
Spaines581373
Swedense2913553
Switzerlandch271785
Taiwantw481410203
Thailandth3421633
Turkeytr211342
Ukraineua4218154
United Arab Emiratesae171213
United Kingdomuk83859461
United Statesus36610850516
Uruguayuy2651513
Venezuelave39201563
Vietnamvn2514343

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

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