---
updatedAt: 2026-06-15T09:50:57.000Z
agentTools:
  projectIndex: https://developers.tidio.com/llms.txt
---

# 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.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Tidio - Openapi",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.tidio.com/"
    }
  ],
  "tags": [
    {
      "name": "Tickets"
    }
  ],
  "security": [
    {
      "ClientId": [],
      "ClientSecret": []
    }
  ],
  "paths": {
    "/tickets": {
      "get": {
        "tags": [
          "Tickets"
        ],
        "summary": "Get tickets",
        "description": "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.\n\nIf you need to fetch a particular ticket with its messages, use the <b>Get ticket details</b> endpoint.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of tickets",
            "content": {
              "application/json; version=1": {
                "schema": {
                  "allOf": [
                    {
                      "type": "object",
                      "properties": {
                        "tickets": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Ticket"
                          }
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/PaginatedResponse"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/PaginationErrorResponse"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "Cursor": {
        "name": "cursor",
        "in": "query",
        "description": "Value from the previous page. Use null to fetch the first one",
        "required": false,
        "explode": false,
        "schema": {
          "type": "string",
          "example": "aWRfX2U2YTgyYTc0LTExNzAtNGY1Ny1hMDMxLWIzNmYzZjZiYzA5Mw=="
        }
      }
    },
    "schemas": {
      "Ticket": {
        "type": "object",
        "properties": {
          "id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TicketID"
              }
            ]
          },
          "link": {
            "type": "string",
            "description": "URL to ticket",
            "format": "url",
            "example": "https://tidio.com/panel/inbox/tickets/10000"
          },
          "subject": {
            "type": "string",
            "description": "Ticket subject",
            "example": "Question about custom product"
          },
          "contact_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ContactID"
              }
            ]
          },
          "contact_email": {
            "type": "string",
            "format": "email",
            "nullable": true,
            "description": "Email of contact where ticket messages are sent",
            "example": "user@tidio.com"
          },
          "priority": {
            "type": "string",
            "description": "Ticket priority",
            "enum": [
              "low",
              "normal",
              "urgent"
            ],
            "example": "normal"
          },
          "status": {
            "type": "string",
            "description": "Ticket status",
            "enum": [
              "open",
              "pending",
              "solved"
            ],
            "example": "open"
          },
          "assigned_operator_id": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "ID of assigned Operator",
            "example": "fc07959a-5c03-4e8d-8ad7-93ec8bbf2e9f"
          },
          "assigned_department_id": {
            "type": "string",
            "format": "uuid",
            "description": "ID of assigned Department",
            "example": "24f59f95-7c5e-434f-affe-b05a8772ef45"
          },
          "custom_channel_id": {
            "type": "string",
            "nullable": true,
            "description": "ID of custom channel attached to given ticket.",
            "example": "01K7PCM5YJHGH8G72MGFK36WKY"
          }
        }
      },
      "Meta": {
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string",
            "nullable": true,
            "description": "Value to fetch the next page. Null means the page is the last one.",
            "example": "aWRfX2U2YTgyYTc0LTExNzAtNGY1Ny1hMDMxLWIzNmYzZjZiYzA5Mw=="
          },
          "limit": {
            "type": "integer",
            "description": "How many items were displayed on list",
            "example": 1000
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "example": "bad_request",
            "title": "Error code"
          },
          "message": {
            "type": "string",
            "title": "More specific description of the error",
            "example": "The request was invalid or cannot be served. "
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "PaginatedResponse": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      },
      "ContactID": {
        "type": "string",
        "format": "uuid",
        "description": "ID of the contact",
        "example": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e"
      },
      "TicketID": {
        "type": "integer",
        "description": "Ticket ID",
        "example": 10000
      }
    },
    "securitySchemes": {
      "ClientId": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Tidio-Openapi-Client-Id"
      },
      "ClientSecret": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Tidio-Openapi-Client-Secret"
      }
    },
    "responses": {
      "PaginationErrorResponse": {
        "description": "Invalid cursor",
        "content": {
          "application/json; version=1": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "errors": [
                {
                  "code": "invalid_cursor",
                  "message": "Cursor is invalid"
                }
              ]
            }
          }
        }
      }
    }
  }
}
```