---
title: "List tickets"
method: GET
path: "/api/tickets"
tags: ["Tickets"]
---

# List tickets

`GET /api/tickets`

List tickets, paginated and ordered by the attribute of the given view.

## Query parameters

- `order_by` 'created_datetime:asc' | 'created_datetime:desc' | 'updated_datetime:asc' | 'updated_datetime:desc'
- `cursor` string
- `customer_id` integer
- `trashed` boolean
- `external_id` string
- `limit` integer
- `view_id` integer
- `rule_id` integer
- `ticket_ids` integer[]

## Response `200`

A list of tickets.

- object
  - `object` string, required
  - `uri` string, required
  - `data` TicketCompact[], required
    - `id` integer, required — ID of the ticket.
    - `uri` string, required — URI of the ticket.
    - `external_id` string, required — External ID of the ticket in a foreign system. This field is not used by Gorgias, feel free to set it as you wish.
    - `language` string, required — The language primarily used in the ticket. The language is automatically detected on the first messages by Gorgias if not set explicitly. Once the language has been set, it won't be updated according to future messages.
    - `status` 'open' | 'closed'
    - `priority` 'critical' | 'high' | 'normal' | 'low'
    - `channel` union, required — The channel used to initiate the conversation with the customer.
      - 'aircall' | 'api' | 'chat' | 'contact_form' | 'email' | 'facebook' | 'facebook-mention' | 'facebook-messenger' | 'facebook-recommendations' | 'help-center' | 'instagram-ad-comment' | 'instagram-comment' | 'instagram-direct-message' | 'instagram-mention' | 'internal-note' | 'phone' | 'sms' | 'twitter' | 'twitter-direct-message' | 'whatsapp' | 'yotpo-review'
      - string
    - `via` 'aircall' | 'api' | 'chat' | 'contact_form' | 'email' | 'facebook' | 'facebook-mention' | 'facebook-messenger' | 'facebook-recommendations' | 'form' | 'gorgias_chat' | 'help-center' | 'helpdesk' | 'instagram' | 'instagram-ad-comment' | 'instagram-comment' | 'instagram-direct-message' | 'instagram-mention' | 'internal-note' | 'offline_capture' | 'phone' | 'rule' | 'self_service' | 'shopify' | 'sms' | 'twilio' | 'twitter' | 'twitter-direct-message' | 'whatsapp' | 'yotpo' | 'yotpo-review' | 'zendesk', required
    - `from_agent` boolean, required — Whether the first message of the ticket was sent by your company to a customer, or the opposite.
    - `customer` TicketCompactCustomer, required
      - `id` integer, required — ID of the customer.
      - `email` string, required — Primary email address of the customer.
      - `name` string, required — Full name of the customer
      - `firstname` string, required — First name of the customer.
      - `lastname` string, required — Last name of the customer.
      - `meta` unknown, required
    - `assignee_user` TicketUser, required
      - `id` integer, required — ID of the user.
      - `email` string, required — Email address of the user. `password_confirmation` field must be provided to change the email.
      - `name` string, required — Full name of the user.
      - `firstname` string, required — First name of the user.
      - `lastname` string, required — Last name of the user.
      - `meta` unknown, required
      - `bio` string, required — Short biography of the user.
    - `assignee_team` TicketTeam, required
      - `id` integer, required — ID of the team.
      - `name` string, required — Name of the team.
      - `decoration` object, required — Object describing how the team appears on the webpage. Currently only supports `emoji` field that shows before the team's name.
    - `subject` string, required — The subject of the ticket.
    - `summary` TicketSummary
      - `content` string, required — The content of the AI summary.
      - `created_datetime` string, date-time, required — When the ticket was summarized by AI for the first time.
      - `updated_datetime` string, date-time, required — When the ticket was summarized by AI for the last time.
      - `triggered_by` integer, required — The id of the user who triggered the summary generation, if triggered manually.
    - `excerpt` string, required — Excerpt of the last message of the ticket.
    - `integrations` TicketCompactIntegration[], required — Messaging integrations involved in the ticket.
      - `name` string, required — Name of the integration
      - `address` string, required — Address specific to the integration
      - `type` 'aircall' | 'alloy' | 'app' | 'bigcommerce' | 'ecom' | 'email' | 'facebook' | 'gmail' | 'gorgias_chat' | 'http' | 'klaviyo' | 'magento2' | 'outlook' | 'phone' | 'recharge' | 'self_service' | 'shopify' | 'smile' | 'smooch' | 'smooch_inside' | 'sms' | 'twitter' | 'whatsapp' | 'yotpo' | 'zendesk', required
    - `meta` unknown, required
    - `tags` TicketTag[], required — [Tags](#the-tag-object) linked to the ticket.
      - `id` integer, required — ID of the tag
      - `name` string, required — Name of the tag. Tags' names are case sensitive.
      - `decoration` TicketTagDecoration, required
        - `color` string — The color of the tag (Hex color code).
    - `messages_count` integer, required — The number of messages in the ticket.
    - `is_unread` boolean, required — Whether the ticket is unread for you.
    - `spam` boolean, required — Whether the ticket is considered as spam or not.
    - `created_datetime` string, date-time, required — When the ticket was created.
    - `opened_datetime` string, date-time, required — When the ticket was opened for the first time by a user.
    - `last_received_message_datetime` string, date-time, required — When the last customer's message was sent.
    - `last_message_datetime` string, date-time, required — When the last message was sent.
    - `last_sent_message_not_delivered` boolean, required — (beta) The last sent message was not delivered.
    - `updated_datetime` string, date-time, required — When the ticket was lastly updated.
    - `closed_datetime` string, date-time, required — When the ticket was closed.
    - `snooze_datetime` string, date-time, required — When the ticket will be re-opened.
    - `trashed_datetime` string, date-time, required — When the ticket was moved to the trash.
    - `custom_fields` object — The custom fields associated with the ticket.
  - `meta` CursorPaginationMeta, required
    - `prev_cursor` string, required
    - `next_cursor` string, required
    - `total_resources` integer, required

---

[API](https://skmtc.net/gorgias/apis/gorgias-rest-api.md) · [All operations](https://skmtc.net/gorgias/apis/gorgias-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gorgias/gorgias-rest-api/versions/36f2e31f4e81/schema)