> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gleap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all tickets

> Get all tickets in a project with support for filtering, sorting, and pagination.

**Filtering:**
- Filter by type: `type=BUG` or `type=BUG,FEATURE_REQUEST`
- Filter by status: `status=OPEN`
- Filter by priority: `priority=HIGH` or `priority=HIGH,MEDIUM`
- Filter by archived state: archived tickets are hidden by default; pass `ignoreArchived=true` to include them,
  or `ignoreArchived=true&archived=true` for archived tickets only
- Filter by spam: `isSpam=false`
- Filter the archive by archive date: `startDate` / `endDate` (ISO 8601) narrow the archive, spam and
  waiting-on-customer views to tickets archived within that range. Ignored on the non-archive views,
  where `archivedAt` is unset.

**Sorting:**
- Sort by creation date: `sort=-createdAt` (newest first) or `sort=createdAt` (oldest first)
- Sort by priority: `sort=priority` (highest first: HIGH, MEDIUM, LOW) or `sort=-priority` (lowest first)
- Sort by updated date: `sort=-updatedAt`
- Default sort (no `sort` param): most recent activity first (`lastNotification` descending)
- Archived, spam and waiting-on-customer views always sort by `archivedAt` descending; a `sort` param is ignored there

**Pagination:**
- Limit results: `limit=20` (default: 500, max: 500)
- Skip results: `skip=0` (for pagination: `skip=(page-1)*limit`)

**Retention — read this before building an export:**
- `type=BOT` conversations (AI conversations that never reached a human) are closed and archived about 3 days
  after they are created, and permanently deleted 30 days after that. Roughly the last 33 days are available;
  older AI-only conversations no longer exist and cannot be exported or restored.
- Every other ticket type is permanently deleted 365 days after it was archived, or after the project's custom
  archive window if one is configured. Unarchived tickets are never deleted by retention.
- A conversation handed over to a human stops being `type=BOT` (it becomes `INQUIRY` or the type the handover
  assigns) and from then on follows the longer window above.
- Ticket history entries have their own 180-day window — see GET /tickets/{ticketId}/history.



## OpenAPI

````yaml https://api.gleap.io/api-docs.json get /tickets
openapi: 3.0.0
info:
  title: gleap-server
  version: 14.0.0
  contact: {}
servers:
  - url: https://api.gleap.io/v3
security: []
paths:
  /tickets:
    get:
      tags:
        - Ticket
      summary: Get all tickets
      description: >-
        Get all tickets in a project with support for filtering, sorting, and
        pagination.


        **Filtering:**

        - Filter by type: `type=BUG` or `type=BUG,FEATURE_REQUEST`

        - Filter by status: `status=OPEN`

        - Filter by priority: `priority=HIGH` or `priority=HIGH,MEDIUM`

        - Filter by archived state: archived tickets are hidden by default; pass
        `ignoreArchived=true` to include them,
          or `ignoreArchived=true&archived=true` for archived tickets only
        - Filter by spam: `isSpam=false`

        - Filter the archive by archive date: `startDate` / `endDate` (ISO 8601)
        narrow the archive, spam and
          waiting-on-customer views to tickets archived within that range. Ignored on the non-archive views,
          where `archivedAt` is unset.

        **Sorting:**

        - Sort by creation date: `sort=-createdAt` (newest first) or
        `sort=createdAt` (oldest first)

        - Sort by priority: `sort=priority` (highest first: HIGH, MEDIUM, LOW)
        or `sort=-priority` (lowest first)

        - Sort by updated date: `sort=-updatedAt`

        - Default sort (no `sort` param): most recent activity first
        (`lastNotification` descending)

        - Archived, spam and waiting-on-customer views always sort by
        `archivedAt` descending; a `sort` param is ignored there


        **Pagination:**

        - Limit results: `limit=20` (default: 500, max: 500)

        - Skip results: `skip=0` (for pagination: `skip=(page-1)*limit`)


        **Retention — read this before building an export:**

        - `type=BOT` conversations (AI conversations that never reached a human)
        are closed and archived about 3 days
          after they are created, and permanently deleted 30 days after that. Roughly the last 33 days are available;
          older AI-only conversations no longer exist and cannot be exported or restored.
        - Every other ticket type is permanently deleted 365 days after it was
        archived, or after the project's custom
          archive window if one is configured. Unarchived tickets are never deleted by retention.
        - A conversation handed over to a human stops being `type=BOT` (it
        becomes `INQUIRY` or the type the handover
          assigns) and from then on follows the longer window above.
        - Ticket history entries have their own 180-day window — see GET
        /tickets/{ticketId}/history.
      operationId: GetTickets
      parameters:
        - in: header
          name: project
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema: {}
              examples:
                Example 1:
                  value:
                    tickets:
                      - _id: 507f1f77bcf86cd799439011
                        id: 507f1f77bcf86cd799439011
                        title: Login button not working
                        formData:
                          description: Users cannot log in when clicking the login button
                        type: BUG
                        status: OPEN
                        priority: HIGH
                        createdAt: '2024-01-15T10:30:00.000Z'
                        updatedAt: '2024-01-15T11:45:00.000Z'
                        processingUser:
                          _id: 507f1f77bcf86cd799439012
                          email: support@example.com
                          firstName: John
                          lastName: Doe
                        session:
                          _id: 507f1f77bcf86cd799439013
                          email: user@example.com
                        latestComment:
                          _id: 507f1f77bcf86cd799439014
                          data:
                            content: Any update on this issue?
                    count: 1
                    totalCount: 42
      security:
        - jwt: []
components:
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT

````