Skip to content
Home/
/Office Hours

Retrieve an office hours exception

Request

You can fetch the details of a single office hours exception.

Security
bearerAuth
Path
office_hours_schedule_idstringrequired

The unique identifier for the office hours schedule.

Example:123
idstringrequired

The unique identifier for the office hours exception.

Example:456
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"2.16"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:2.16
using System;
using System.Net.Http;
using System.Threading.Tasks;

public class Program
{
  public static async Task Main()
  {
    System.Net.Http.HttpClient client = new()
    {
      DefaultRequestHeaders =
      {
        {"Intercom-Version", "2.16"},
        {"Authorization", "Bearer <YOUR_TOKEN_HERE>"},
      }
    };

      var OfficeHoursScheduleId = "123";
      var Id = "456";
    using HttpResponseMessage request = await client.GetAsync("https://api.intercom.io/office_hours_schedules/" + OfficeHoursScheduleId + "/office_hours_exceptions/" + Id);
    string response = await request.Content.ReadAsStringAsync();

    Console.WriteLine(response);
  }
}

Responses

Office hours exception found

Bodyapplication/json
typestring

The type of the object - always office_hours_exception.

Example:"office_hours_exception"
idstring

The unique identifier for the office hours exception.

Example:"456"
office_hours_schedule_idstring

The unique identifier for the schedule this exception belongs to.

Example:"123"
exception_datestring, (date)

The date the exception applies to, in YYYY-MM-DD format.

Example:"2026-12-25"
exception_typestring

closed means the workspace is closed all day; custom_hours replaces the regular hours with time_intervals.

Enum:"closed""custom_hours"
Example:"closed"
namestring or null

An optional name for the exception.

Example:"Christmas Day"
time_intervalsArray of objects or null(Office Hours Time Interval)

The open intervals for the exception date. null when exception_type is closed.

recurring_annuallyboolean

Whether the exception repeats every year on the same date.

Example:true
created_atinteger

The time the exception was created as a Unix timestamp.

Example:1717200000
updated_atinteger

The time the exception was last updated as a Unix timestamp.

Example:1717200000
Response
{
  "type": "office_hours_exception",
  "id": "456",
  "office_hours_schedule_id": "123",
  "exception_date": "2026-12-25",
  "exception_type": "closed",
  "name": "Christmas Day",
  "time_intervals": null,
  "recurring_annually": true,
  "created_at": 1717200000,
  "updated_at": 1717200000
}