Tickets

Get ticket details

Ticket is a record of more complex conversations between operators and customers, which often require additional interactions or cannot be closed in a single chat conversation. It usually also consists of emails and internal messages. This endpoint allows you to retrieve all details of a single ticket with messages.

get/tickets/{ticketId}

Request

Base URL
https://api.tidio.com
URL
https://api.tidio.com/tickets/{ticketId}
Auth
API key in header X-Tidio-Openapi-Client-Id and API key in header X-Tidio-Openapi-Client-Secret

Path parameters

ticketIdinteger required

Ticket ID

Example:10000

Response

Returns ticket object on success

idinteger

Ticket ID

linkstring url

URL to ticket

subjectstring

Ticket subject

contact_idstring uuid

ID of the contact

contact_emailstring email nullable

Email of contact where ticket messages are sent

priority'low' | 'normal' | 'urgent'

Ticket priority

status'open' | 'pending' | 'solved'

Ticket status

assigned_operator_idstring uuid nullable

ID of assigned Operator

assigned_department_idstring uuid

ID of assigned Department

custom_channel_idstring nullable

ID of custom channel attached to given ticket.

Example response

{
  "id": 10000,
  "link": "https://tidio.com/panel/inbox/tickets/10000",
  "subject": "Question about custom product",
  "contact_id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e",
  "contact_email": "user@tidio.com",
  "priority": "normal",
  "status": "open",
  "assigned_operator_id": "fc07959a-5c03-4e8d-8ad7-93ec8bbf2e9f",
  "assigned_department_id": "24f59f95-7c5e-434f-affe-b05a8772ef45",
  "custom_channel_id": "01K7PCM5YJHGH8G72MGFK36WKY",
  "messages": [
    {
      "message_id": "01H6XZJ88T5PMRRQC3C54WY1EJ",
      "created_at": "2023-08-01T14:42:29+00:00",
      "author_type": "operator",
      "author_id": "3a7439a0-e939-4d8f-847c-be87197f2330",
      "message_type": "public",
      "attachments": [
        "https://example.com"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.