Tickets

Get tickets

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 the list of all the tickets with it’s details but without messages.

If you need to fetch a particular ticket with its messages, use the <b>Get ticket details</b> endpoint.

get/tickets

Request

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

Query parameters

cursorstring

Example:aWRfX2U2YTgyYTc0LTExNzAtNGY1Ny1hMDMxLWIzNmYzZjZiYzA5Mw==

Value from the previous page. Use null to fetch the first one

Response

Paginated list of tickets

Example response

{
  "tickets": [
    {
      "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"
    }
  ],
  "meta": {
    "cursor": "aWRfX2U2YTgyYTc0LTExNzAtNGY1Ny1hMDMxLWIzNmYzZjZiYzA5Mw==",
    "limit": 1000
  }
}

Changes

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