Skip to content
Home/
REST API Reference
/
/
Retrieve an SLA rule

Retrieve an SLA rule

Request

You can fetch the details of a single SLA rule, including archived SLA rules.

Requires the read_conversations OAuth scope.

Security
bearerAuth
Path
idstringrequired

The unique identifier for the SLA rule.

Example:12
Headers
Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"
Value:"Preview"
Example:Preview
curl -i -X GET \
  https://api.intercom.io/sla_rules/12 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

SLA rule found

Bodyapplication/json
typestring

The type of the object - always sla_rule.

Example:"sla_rule"
idstring

The unique identifier for the SLA rule.

Example:"12"
namestring

The name of the SLA rule. It is unique within the workspace.

Example:"VIP customers"
created_atinteger

The time the SLA rule was created as a Unix timestamp.

Example:1717200000
updated_atinteger

The time the SLA rule was last updated as a Unix timestamp.

Example:1719800000
archivedboolean

Whether the SLA rule is archived.

Example:false
archived_atinteger or null

The time the SLA rule was archived as a Unix timestamp, or null if it is not archived.

Example:1721000000
first_reply_time_in_secondsinteger or null

The target time in seconds for the first reply, or null if no target is set.

Example:3600
next_reply_time_in_secondsinteger or null

The target time in seconds for a teammate to reply to each subsequent customer message, or null if no target is set.

Example:7200
time_to_close_in_secondsinteger or null

The target time in seconds for closing the conversation, or null if no target is set.

Example:172800
resolution_time_in_secondsinteger or null

The target time in seconds for a ticket to be resolved, or null if no target is set.

Example:86400
speed_of_answer_in_secondsinteger or null

The target time in seconds to answer an inbound phone call, or null if no target is set. This timer does not pause.

Example:120
office_hours_schedule_idstring or null

The unique identifier for the office hours schedule the SLA rule's timers count against. This is the SLA rule's own schedule if it has one, otherwise the workspace's default schedule. It is null if neither exists.

Example:"123"
pause_on_waiting_on_customerboolean

Whether the SLA rule's timers pause while the conversation is waiting on the customer.

Example:true
pause_on_snoozeboolean

Whether the SLA rule's timers pause while the conversation is snoozed.

Example:false
Response
{
  "type": "sla_rule",
  "id": "12",
  "name": "VIP customers",
  "created_at": 1717200000,
  "updated_at": 1719800000,
  "archived": false,
  "archived_at": null,
  "first_reply_time_in_seconds": 3600,
  "next_reply_time_in_seconds": null,
  "time_to_close_in_seconds": null,
  "resolution_time_in_seconds": 86400,
  "speed_of_answer_in_seconds": null,
  "office_hours_schedule_id": "123",
  "pause_on_waiting_on_customer": true,
  "pause_on_snooze": false
}