v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Ticket States

List all ticket states

You can get a list of all ticket states for a workspace.

get/ticket_states

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

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

Example:2.14

Response

successful

typestring

String representing the object's type. Always has the value list.

Example response

{
  "type": "list",
  "data": [
    {
      "type": "ticket_state",
      "id": "12",
      "category": "in_progress",
      "internal_label": "With Dev Team",
      "external_label": "In Progress",
      "ticket_types": {
        "type": "list",
        "data": [
          {
            "type": "ticket_type",
            "id": "1295",
            "category": "Customer",
            "name": "Bug",
            "description": "A bug that has been reported.",
            "icon": "🐞",
            "workspace_id": "ecahpwf5",
            "ticket_type_attributes": {
              "ticket_type_attributes": [
                {
                  "type": "ticket_type_attribute",
                  "id": "1",
                  "workspace_id": "ecahpwf5",
                  "name": "Title",
                  "description": "Bug title.",
                  "data_type": "string",
                  "order": 1,
                  "default": true,
                  "ticket_type_id": 42
                }
              ]
            },
            "ticket_states": {
              "type": "list",
              "data": [
                {
                  "type": "ticket_state",
                  "id": "12",
                  "category": "in_progress",
                  "internal_label": "With Dev Team",
                  "external_label": "In Progress"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}