Holiday Service

Retrieve a list of public holidays and observances for all 170+ 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).
  • Access to all years with available data included.

Data coverage

Browse holiday countries

Sample Data

Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=2&out=json&prettyprint=1&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}

{

  "version": 2,
  "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-01",
      "datetime": {
        "year": 2011,
        "month": 1,
        "day": 1,
        "hour": 0,
        "minute": 0,
        "second": 0
      }
    },
    "uid": "0007d600000007db",
  }
}

Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=2&out=xml&prettyprint=1&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}

<?xml version="1.0" encoding="UTF-8"?>
<data version="2">
  <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-01">
        <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>

Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=2&out=text&template=ics&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//TIMEANDDATE AS//NONSGML//EN
BEGIN:VEVENT
DTSTAMP:20150320T080415Z
UID:0007d600000007db@timeanddate.com
DTSTART;VALUE=DATE:20110101
DTEND;VALUE=DATE:20110102
SUMMARY:New Year's Day
DESCRIPTION:New Year's Day is the first day of the Gregorian calendar\, whi
 ch is widely used in many countries such as the USA.\n\nRead more: http://
 www.timeanddate.com/holidays/us/new-year-day
LOCATION:United States
X-TAD-URL;VALUE=URI:http://www.timeanddate.com/holidays/us/new-year-day
X-TAD-TYPE;VALUE=TEXT:National holiday
X-TAD-COUNTRY;VALUE=TEXT:us
END:VEVENT
END:VCALENDAR

Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=2&out=text&template=csv&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}

Date,Name,Year,Month,Day,Weekday,Types,IsObserved,Country,Locations,States
2011-01-01,"New Year's Day",2011,1,1,Sat,National holiday,,United States,,
2011-01-17,Martin Luther King Day,2011,1,17,Mon,National holiday,,United States,,
2011-02-14,"Valentine's Day",2011,2,14,Mon,Observance,,United States,,
2011-02-21,"Presidents' Day",2011,2,21,Mon,National holiday,,United States,,
2011-04-24,Easter Sunday,2011,4,24,Sun,"Observance,Christian",,United States,,
2011-05-08,"Mother's Day",2011,5,8,Sun,Observance,,United States,,
2011-05-30,Memorial Day,2011,5,30,Mon,National holiday,,United States,,
2011-06-19,"Father's Day",2011,6,19,Sun,Observance,,United States,,
2011-07-04,Independence Day,2011,7,4,Mon,National holiday,,United States,,
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com