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

# Listar tickets

> Lista os tickets do escritório com filtros e paginação.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /tickets/
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /tickets/:
    get:
      tags:
        - Tickets
      summary: Listar tickets
      description: Lista os tickets do escritório com filtros e paginação.
      parameters:
        - schema:
            anyOf:
              - type: string
              - type: number
          in: query
          name: page
          required: false
          description: Número da página.
        - schema:
            anyOf:
              - type: string
              - type: number
          in: query
          name: limit
          required: false
          description: Quantidade de itens por página.
        - schema:
            type: string
            enum:
              - open
              - all
            default: open
          in: query
          name: status
          required: false
          description: Filtro de status. "open" = status com isClosed=false. "all" = todos.
        - schema:
            type: string
            minLength: 1
          in: query
          name: statusId
          required: false
          description: 'Filtra por um status específico (ex.: paginação de coluna do board).'
        - schema:
            anyOf:
              - type: string
                pattern: ^[cC][^\s-]{8,}$
              - type: array
                items:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
          in: query
          name: statusIds
          required: false
          description: Filtra por um ou mais status customizados.
        - schema:
            anyOf:
              - type: string
                pattern: ^[cC][^\s-]{8,}$
              - type: array
                items:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
          in: query
          name: tagIds
          required: false
          description: Filtra por uma ou mais etiquetas.
        - schema:
            anyOf:
              - type: string
                pattern: ^[cC][^\s-]{8,}$
              - type: array
                items:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
          in: query
          name: assigneeIds
          required: false
          description: Filtra por um ou mais responsáveis.
        - schema:
            anyOf:
              - type: string
                pattern: ^[cC][^\s-]{8,}$
              - type: array
                items:
                  type: string
                  pattern: ^[cC][^\s-]{8,}$
          in: query
          name: departmentIds
          required: false
          description: Filtra por um ou mais setores.
        - schema:
            type: string
          in: query
          name: title
          required: false
          description: Filtra pelo título do ticket.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: conversationId
          required: false
          description: Filtra tickets vinculados a uma conversa.
        - schema:
            type: string
            enum:
              - LOW
              - MEDIUM
              - HIGH
          in: query
          name: priority
          required: false
          description: Filtra por prioridade do ticket.
        - schema:
            type: string
            format: date-time
          in: query
          name: startedAt
          required: false
          description: Filtra tickets com data inicial a partir desta data.
        - schema:
            type: string
            format: date-time
          in: query
          name: endedAt
          required: false
          description: Filtra tickets com data final até esta data.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: assigneeId
          required: false
          description: Obsoleto. Prefira assigneeIds.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: departmentId
          required: false
          description: Obsoleto. Prefira departmentIds.
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Obsoleto. Prefira title.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalResults:
                    type: number
                    description: Total de registros encontrados.
                  totalPages:
                    type: number
                    description: Total de páginas para a quantidade solicitada.
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        officeId:
                          type: string
                        number:
                          type: integer
                          exclusiveMinimum: true
                          minimum: 0
                        code:
                          type: string
                        title:
                          type: string
                        description:
                          type: string
                          nullable: true
                        status:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            color:
                              type: string
                            isClosed:
                              type: boolean
                            index:
                              type: integer
                          required:
                            - id
                            - name
                            - color
                            - isClosed
                            - index
                          additionalProperties: false
                        priority:
                          type: string
                          enum:
                            - LOW
                            - MEDIUM
                            - HIGH
                        conversationId:
                          type: string
                          nullable: true
                        conversation:
                          type: object
                          properties:
                            id:
                              type: string
                            person:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                  nullable: true
                                phoneNumber:
                                  type: string
                                  nullable: true
                              required:
                                - id
                                - name
                                - phoneNumber
                              additionalProperties: false
                              nullable: true
                          required:
                            - id
                            - person
                          additionalProperties: false
                          nullable: true
                        createdByUserId:
                          type: string
                        createdBy:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            email:
                              type: string
                            imageUrl:
                              type: string
                              nullable: true
                              description: Foto de perfil. Null se não houver.
                          required:
                            - id
                            - name
                            - email
                            - imageUrl
                          additionalProperties: false
                        isPublic:
                          type: boolean
                        publicToken:
                          type: string
                          nullable: true
                        publicUrl:
                          type: string
                          nullable: true
                        assignees:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              email:
                                type: string
                              imageUrl:
                                type: string
                                nullable: true
                                description: Foto de perfil. Null se não houver.
                            required:
                              - id
                              - name
                              - email
                              - imageUrl
                            additionalProperties: false
                        departments:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                            required:
                              - id
                              - name
                            additionalProperties: false
                        tags:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              color:
                                type: string
                            required:
                              - id
                              - name
                              - color
                            additionalProperties: false
                        attachments:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              fileName:
                                type: string
                              mimeType:
                                type: string
                              sizeBytes:
                                type: integer
                                minimum: 0
                              url:
                                type: string
                                nullable: true
                              createdAt:
                                type: string
                                format: date-time
                            required:
                              - id
                              - fileName
                              - mimeType
                              - sizeBytes
                              - url
                              - createdAt
                            additionalProperties: false
                        updatesCount:
                          type: integer
                          minimum: 0
                        lastUpdate:
                          type: object
                          properties:
                            content:
                              type: string
                            createdAt:
                              type: string
                              format: date-time
                            createdBy:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                email:
                                  type: string
                              required:
                                - id
                                - name
                                - email
                              additionalProperties: false
                              nullable: true
                          required:
                            - content
                          additionalProperties: false
                          nullable: true
                        startedAt:
                          type: string
                          format: date-time
                          nullable: true
                        endedAt:
                          type: string
                          format: date-time
                          nullable: true
                        points:
                          type: integer
                          minimum: 0
                          nullable: true
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - officeId
                        - number
                        - code
                        - title
                        - description
                        - status
                        - priority
                        - conversationId
                        - conversation
                        - createdByUserId
                        - createdBy
                        - isPublic
                        - publicToken
                        - publicUrl
                        - assignees
                        - departments
                        - tags
                        - attachments
                        - updatesCount
                        - lastUpdate
                        - startedAt
                        - endedAt
                        - points
                        - createdAt
                        - updatedAt
                      additionalProperties: false
                  counters:
                    type: object
                    properties:
                      statuses:
                        type: array
                        items:
                          type: object
                          properties:
                            statusId:
                              type: string
                            name:
                              type: string
                            color:
                              type: string
                            isClosed:
                              type: boolean
                            count:
                              type: integer
                              minimum: 0
                          required:
                            - statusId
                            - name
                            - color
                            - isClosed
                            - count
                          additionalProperties: false
                      open:
                        type: integer
                        minimum: 0
                      all:
                        type: integer
                        minimum: 0
                    required:
                      - statuses
                      - open
                      - all
                    additionalProperties: false
                required:
                  - totalResults
                  - totalPages
                  - data
                  - counters
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  code:
                    type: string
                  details:
                    anyOf:
                      - type: string
                      - type: number
                      - type: boolean
                      - type: object
                        properties: {}
                        additionalProperties: true
                    description: Detalhes adicionais do erro.
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````