Holiday Web Service

With no programming required, you can add the dates of Holidays to your Google Desktop and personalized Google homepage by using our new gadget!

Add to Google

Do you want to add these Holidays to your site? You can add this gadget to your site! No coding required!

Countries Supported

United States
Great Britain & Wales
Northern Ireland
Republic of Ireland
Canada

HolidayService2

Note! if you are here to find the dates of specific holidays because you searched for "national holidays", "federal holidays" or "bank holidays", you can use this site to view the dates of holidays for a specific year.

Description

The Holiday Service v2 allows developers to retrieve holiday dates based on a provided country code and date ranges.

Request URL

http://www.holidaywebservice.com/HolidayService_v2/HolidayService2.asmx

Methods

GetCountriesAvailable (returns Collection of CountryCode objects)
Parameter Value Description
* None
 
GetHolidaysAvailable (returns Collection of HolidayCode objects)
Parameter Value Description
countryCode Country enumeration (required) Value from Country enumeration. See Country enumeration for the list of countries currently supported.
 
GetHolidayDate (returns Date)
Parameter Value Description
countryCode Country enumeration (required) Value from Country enumeration. See Country enumeration for the list of countries currently supported.
holidayCode String (required) Code returned from GetHolidaysAvailable(). See HolidayCode object definition for the list of holiday codes currently supported for a specific country.
year Integer (required) Year to calculate the date of the holiday for.
 
GetHolidaysForDateRange (returns Collection of Holiday objects)
Parameter Value Description
countryCode Country enumeration (required) Value from Country enumeration. See Country enumeration for the list of countries currently supported.
startDate Date (required) Start date of range to include in returned data.
endDate Date (required) End date of range (inclusive) to include in returned data.
 
GetHolidaysForYear (returns Collection of Holiday objects)
Parameter Value Description
countryCode Country enumeration (required) Value from Country enumeration. See Country enumeration for the list of countries currently supported.
year Integer (required) Year to calculate the date of the holidays for.
 
GetHolidaysForMonth (returns Collection of Holiday objects)
Parameter Value Description
countryCode Country enumeration (required) Value from Country enumeration. See Country enumeration for the list of countries currently supported.
year Integer (required) Year to calculate the date of the holidays for.
month Integer (required) Month to calculate the date of the holidays for.

Return to Services Available