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

# Listar tickets

> Lista paginada de tickets da company, com filtros por status, prioridade, departamento e busca.



## OpenAPI

````yaml /openapi.json get /api/v1/tickets
openapi: 3.0.0
info:
  title: WiseDesk API
  description: >-
    API REST pública do WiseDesk: tickets, cadastros, base de conhecimento,
    Agile e analytics.


    Autentique enviando a API key no header `X-API-Key` (ou `Authorization:
    Bearer wd_live_...`).

    Cada key tem escopos — rotas fora dos escopos retornam `403
    insufficient_scope`:


    - `tickets:read` — Ler tickets, mensagens, comentários, anexos e histórico

    - `tickets:write` — Criar e atualizar tickets, responder e comentar

    - `customers:read` — Ler clientes, departamentos e clientes finais

    - `customers:write` — Criar e atualizar clientes, departamentos e clientes
    finais

    - `kb:read` — Ler artigos da base de conhecimento

    - `kb:write` — Criar e atualizar artigos da base de conhecimento

    - `agile:read` — Ler projetos, sprints, boards, épicos e tasks

    - `agile:write` — Criar e atualizar sprints, boards, épicos e tasks

    - `analytics:read` — Ler dashboards e métricas (tickets e agile)


    Limite de requisições por key (padrão 120/min), informado nos headers
    `X-RateLimit-*`.
  version: '1.0'
  contact: {}
servers:
  - url: https://wisedesk-api.wiseapp360.com
    description: Produção
security: []
tags: []
paths:
  /api/v1/tickets:
    get:
      tags:
        - Tickets
      summary: Listar tickets
      description: >-
        Lista paginada de tickets da company, com filtros por status,
        prioridade, departamento e busca.
      operationId: Tickets_list
      parameters:
        - name: page
          required: false
          in: query
          description: Número da página (inicia em 1)
          schema:
            default: 1
            example: 1
            type: number
        - name: limit
          required: false
          in: query
          description: 'Itens por página (máx: 100)'
          schema:
            default: 50
            example: 50
            type: number
        - name: search
          required: false
          in: query
          description: Busca por título, descrição ou cliente
          schema:
            example: problema veículo
            type: string
        - name: status
          required: false
          in: query
          description: 'Filtrar por status. Valores: open, in_progress, pending, completed'
          schema:
            $ref: '#/components/schemas/TicketStatus'
        - name: priority
          required: false
          in: query
          description: 'Filtrar por prioridade. Valores: urgent, high, medium, low'
          schema:
            $ref: '#/components/schemas/Priority'
        - name: departamento
          required: false
          in: query
          description: Filtrar por ID numérico do departamento
          schema:
            example: '1'
            type: string
        - name: companyId
          required: false
          in: query
          description: >-
            Restringir a uma empresa (apenas Master/superadmin — ignorado para
            outros roles)
          schema:
            type: string
        - name: projetoId
          required: false
          in: query
          description: >-
            Restringir a um projeto (seletor PROJETO do sidebar). Política:
            tickets do projeto OU tickets sem projeto vinculado.
          schema:
            type: string
      responses:
        '200':
          description: ''
        '401':
          description: API key ausente, inválida, expirada ou revogada
        '403':
          description: API key sem o escopo exigido (insufficient_scope)
        '429':
          description: Limite de requisições por minuto da key excedido
      security:
        - api-key: []
components:
  schemas:
    TicketStatus:
      type: string
      description: 'Status do ticket. Valores: open, in_progress, pending, completed'
      enum:
        - open
        - in_progress
        - pending
        - completed
    Priority:
      type: string
      description: 'Prioridade do ticket. Valores: urgent, high, medium, low'
      enum:
        - urgent
        - high
        - medium
        - low
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key no formato wd_live_...

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.