---
title: "Retrieve location holidays"
method: GET
path: "/locations/{locationId}/holidays"
tags: ["AfterHours"]
---

# Retrieve location holidays

`GET /locations/{locationId}/holidays`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/locations/{locationId}/holidays`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/locations/:locationId/holidays/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the details of each holiday for the specified location.

## Path parameters

- `locationId` integer, required

## Response `200`

Location holidays are in the response.

- ServiceChannelServicesMessagingAfterHoursHolidaysApiResponse: Object containing the details of a location holiday.
  - `TimeZoneShortDescription` string: Location’s timezone abbreviation.
  - `Holidays` ServiceChannelServicesMessagingAfterHoursHolidayApiResponse[]
    - `HolidayName` string: Holiday name.
    - `StartDate` string, date-time: Holiday date.
    - `OpenTime` string: Location opening hours.
    - `CloseTime` string: Location closing hours.
    - `ClosedAllDay` boolean: Defines whether the location is closed on the specified day.
    - `Frequency` string: Defines how often the holiday occurs. Valid values: Singular, Weekly, Monthly, Yearly.
    - `RepeatEvery` string, byte: Defines intervals for the holiday to repeat. Valid values: a number from 1 to 60. Used in combination with the `Frequency` values: Yearly, Monthly, Weekly.
    - `RepeatBy` string: Defines whether the holiday repeats on days of the month or week. Valid values: DaysOfWeek, DaysOfMonth.
    - `RepeatOnDays` string[]: Days when the holiday occurs. Used in combination with the `Frequency` value ‘Weekly’.
    - `RepeatOnMonths` string[]: Months when the holiday occurs. Used in combination with the `Frequency` value ‘Yearly’.

## Other responses

- `400`: The request is not accepted due to bad syntax, missing parameters, insufficient data, etc. <br/>Error codes: <br/> 601 — Location is not found;
- `401`: The request is not authorized. <br/>Error codes: <br/> 504 — API call rejected by security permissions
- `500`: The server was unable to complete the request due to an internal error.

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)