United States
Great Britain & Wales
Northern Ireland
Republic of Ireland
Canada
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.
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.
http://www.holidaywebservice.com/Holidays/HolidayService.asmx
| 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. |
1.2.1 (*** Deprecated; replaced by v2 services ***, see Change History)