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
Sample Data
Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=3&out=json&prettyprint=1&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}
{
"version": 3,
"billing": {
"credits": 1
},
"holidays": [{
"id": 2006,
"urlid": "us/new-year-day",
"url": "https://www.timeanddate.com/holidays/us/new-year-day",
"country": {
"id": "us",
"name": "United States"
},
"name": [{
"lang": "en",
"text": "New Year's Day"
}],
"oneliner": [{
"lang": "en",
"text": "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
}
},
"uid": "0007d600000007db"
}]
}
Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=3&out=xml&prettyprint=1&accesskey={KEY}&expires={TIMESTAMP}&signature={SIGNATURE}
<?xml version="1.0" encoding="UTF-8"?>
<data version="3">
<billing>
<credits>1</credits>
</billing>
<holidays>
<holiday id="2006" urlid="us/new-year-day" url="https://www.timeanddate.com/holidays/us/new-year-day">
<country id="us">United States</country>
<name>
<text lang="en">New Year's Day</text>
</name>
<oneliner>
<text lang="en">New Year's Day is the first day of the Gregorian calendar, which is widely used in many countries such as the USA.</text>
</oneliner>
<types>
<type>National holiday</type>
</types>
<date iso="2011-01-01">
<datetime>
<year>2011</year>
<month>1</month>
<day>1</day>
</datetime>
</date>
<uid>0007d600000007db</uid>
</holiday>
</holidays>
</data>
Example Request: https://api.xmltime.com/holidays?country=us&year=2011&version=3&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:[email protected] 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=3&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,,
