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

HolidayService v1 (*** Deprecated ***)

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 allows developers to retrieve holiday dates based on a provided country code and date ranges. Note: this version 1 service has been deprecated and has been replaced with the v2 services.

Request URL

http://www.holidaywebservice.com/Holidays/HolidayService.asmx

Methods

GetCountriesAvailable (returns Dataset)
Parameter Value Description
* None
 
GetHolidaysAvailable (returns Dataset)
Parameter Value Description
countryCode String (required) The ISO country code. See Country Codes for the list of countries currently supported.
 
GetHolidayDate (returns Date)
Parameter Value Description
countryCode String (required) The ISO country code. See Country Codes for the list of countries currently supported.
holidayName String (required) The holiday key name. This holiday key name is specific to the country being requested.
year Integer (required) The year to calculate the date of the holiday.
 
GetHolidaysForDateRange (returns Dataset)
Parameter Value Description
countryCode String (required) The ISO country code. See Country Codes for the list of countries currently supported.
startDate Date (required) Date to start retrieving holidays. Suggested format, YYYY-MM-DD.
endDate Date (required) Date to end retrieving holidays. Suggested format, YYYY-MM-DD.
 
GetHolidaysForMonth (returns Dataset)
Parameter Value Description
countryCode String (required) The ISO country code. See Country Codes for the list of countries currently supported.
month Integer (required) Month number to retrieve holidays.
year Integer (required) Year to retrieve holidays.
 
GetHolidaysForYear (returns Dataset)
Parameter Value Description
countryCode String (required) The ISO country code. See Country Codes for the list of countries currently supported.
year Integer (required) Year to retrieve holidays.

Current Version

1.2.1 (*** Deprecated; replaced by v2 services ***, see Change History)

Return to Services Available