GET/ticket_states

List ticket states

Lists the ticket states associated with ticket types in the workspace. Use the returned state details to see their labels, categories, and ticket type associations.

1 parameter
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a list of ticket states, including their categories, internal and external labels, archived status, and ticket type associations.
typestringoptional
String representing the object's type. Always has the value `list`.
dataarray<TicketState>optional
A list of ticket states associated with a given ticket type.
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

Error handling

A 401 is returned when the request is unauthorized. The Intercom-Version header selects the API version and defaults to 2.17 when omitted.