---
title: "List view's items"
method: GET
path: "/api/views/{view_id}/items"
tags: ["Views"]
---

# List view's items

`GET /api/views/{view_id}/items`

List view's items, paginated, and ordered by the attribute specified in the data of view.

## Path parameters

- `view_id` integer, required

## Query parameters

- `cursor` string
- `direction` 'prev' | 'next', nullable
- `ignored_item` integer
- `limit` integer
- `order_by` 'created_datetime:asc' | 'created_datetime:desc' | 'updated_datetime:asc' | 'updated_datetime:desc' | 'last_message_datetime:asc' | 'last_message_datetime:desc' | 'last_received_message_datetime:asc' | 'last_received_message_datetime:desc' | 'closed_datetime:asc' | 'closed_datetime:desc' | 'snooze_datetime:asc' | 'snooze_datetime:desc' | 'priority:asc' | 'priority:desc'

## Response `200`

A list of view's items.

- object
  - `data` object[]
    - `id` integer — ID of the object
    - `uri` string — URI of the object (auto-generated)
    - `external_id` string, nullable — Another ID for the ticket. Can be set freely.
    - `language` string, nullable — The [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language code of the client's messages on this ticket. This field is automatically generated by Gorgias if empty.
    - `status` string — Ticket status is used for managing the lifecycle of the ticket
    - `priority` string — Indicates the importance of the ticket.
    - `channel` string — The channel used to communicate with the user on this ticket.If not specified, it will be filled with the channel of the first [TicketMessage](#TicketMessage-object) of this ticket.
    - `via` string — Indicates via which means this ticket was created. If not specified, it will be filled with the `via` value of the first [TicketMessage](#TicketMessage-object) of this ticket.For example, a ticket of channel `email` could have been created through the API because of an integration; the `via` would then be `api`.
    - `from_agent` boolean — Indicates whether the ticket has been created because a user or a customer sent a message. If not specified, it will be filled with the `from_agent` value of the first [TicketMessage](#TicketMessage-object) of this ticket.
    - `customer` object, required — The user who is requesting something in this ticket.
      - `id` integer — ID of the object
      - `email` string, email, nullable — Primary email address of the customer
      - `name` string, nullable — Full name of the customer
      - `firstname` string — First name of the customer. This field is read-only and generated using the name field
      - `lastname` string — Last name of the customer. This field is read-only and generated using the name field
      - `meta` unknown
    - `assignee_user` object — The agent assigned to this ticket.
      - `id` integer — ID of the object
      - `email` string, email, nullable — The email address of the user
      - `name` string, nullable — The full name of the user
      - `firstname` string — The first name of the user. This field is read-only and generated using the name field
      - `lastname` string — The last name of the user. This field is read-only and generated using the name field
      - `meta` unknown
      - `bio` string, nullable — A short biography of the user
    - `assignee_team` object — The team assigned to this ticket.
      - `id` integer — ID of the object
      - `name` string, required — Name of the team.
      - `decoration` unknown
    - `subject` string, nullable — The subject of the ticket. If not specified, it will be filled with the subject of the first [TicketMessage](#TicketMessage-object) of this ticket.
    - `excerpt` string
    - `integrations` object[]
    - `meta` unknown
    - `tags` object[] — The tags associated with the ticket.
      - `id` integer — ID of the object
      - `name` string, required
      - `uri` string — URI of the object (auto-generated)
      - `decoration` unknown
    - `messages_count` integer
    - `is_unread` boolean
    - `spam` boolean, nullable — Indicates whether the ticket is considered as spam or not.
    - `created_datetime` string, date-time, nullable — When the ticket was created.
    - `opened_datetime` string, date-time, nullable — When the ticket was opened for the first time.
    - `last_received_message_datetime` string, date-time, nullable — When a message was received for the last time.
    - `last_message_datetime` string, date-time, nullable — When a message was received or sent for the last time.
    - `updated_datetime` string, date-time, nullable — When the ticket was updated for the last time.
    - `closed_datetime` string, date-time, nullable — When the ticket was closed for the last time.
    - `snooze_datetime` string, date-time, nullable — When the ticket will be automatically re-open. Set if an agent wants to come back to this ticket later
    - `trashed_datetime` string, date-time, nullable — When the ticket was moved to the trash for the last time.
    - `last_sent_message_not_delivered` boolean, nullable
  - `meta` ViewItemsListRespMeta
    - `current_cursor` string — Value indicating your position in the list of all the view's items.
    - `next_items` string, url — Link to the next items, if any.
    - `prev_items` string, url — Link to the previous items, if any.

---

[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)