Intercom API (unofficial showcase)
GET/office_hours_schedules/{office_hours_schedule_id}/office_hours_exceptions/{id}

Retrieve an office hours exception

Retrieves a single office hours exception for a schedule. Use the schedule and exception identifiers to locate the date-specific override to the schedule's regular hours.

3 parameters
office_hours_schedule_idstringrequired
The unique identifier of the office hours schedule that contains the exception.
idstringrequired
The unique identifier of the office hours exception to retrieve.
Intercom-Versionstringoptional
The Intercom API version to use. Supported versions include the listed values; defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns the office hours exception, including its date, exception type, time intervals, annual recurrence setting, and timestamps.
typestringoptional
The type of the object - always `office_hours_exception`.
idstringoptional
The unique identifier for the office hours exception.
office_hours_schedule_idstringoptional
The unique identifier for the schedule this exception belongs to.
exception_datestringoptional
The date the exception applies to, in `YYYY-MM-DD` format.
exception_typestringoptional
`closed` means the workspace is closed all day; `custom_hours` replaces the regular hours with `time_intervals`.
Allowed:closedcustom_hours
namestringoptional
An optional name for the exception.
time_intervalsarray<OfficeHoursTimeInterval>optional
The open intervals for the exception date. `null` when `exception_type` is `closed`.
recurring_annuallybooleanoptional
Whether the exception repeats every year on the same date.
created_atintegeroptional
The time the exception was created as a Unix timestamp.
updated_atintegeroptional
The time the exception was last updated as a Unix timestamp.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the requested schedule or exception is not found.

2 documented failures

  • not_found

    Object not found

  • data_invalid

    Integration not found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. A 404 is returned when the schedule or exception cannot be found; the office_hours_schedule_id path parameter and id path parameter must identify the associated schedule and exception.