> ## Documentation Index > Fetch the complete documentation index at: https://developers.sults.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Listar chamados na API v2 do SULTS > Lista os chamados da plataforma, com solicitante, responsável, unidade, departamento de destino, assunto, apoios, etiquetas, prazos e situação. Sem o filtro `status`, a resposta traz só os chamados em aberto (`NEW`, `IN_PROGRESS`, `AWAITING_REQUESTER` e `AWAITING_ASSIGNEE`): para ver resolvidos e concluídos, informe `RESOLVED` ou `CLOSED` em `status`. Cada página traz até 100 chamados. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /api/v2/chamados/ticket/list openapi: 3.1.0 info: title: API do SULTS v2 version: '2.0' description: >- A nova geração da API do SULTS, em migração módulo a módulo (Compras primeiro). Autenticação por token v2 no cabeçalho `Authorization`; tokens v1 não funcionam aqui. Nas requisições com corpo, envie `Content-Type: application/json;charset=UTF-8`. contact: name: Suporte SULTS url: https://ajuda.sults.com.br servers: - url: https://api.sults.com.br security: - apiKeyAuth: [] tags: - name: Produtos description: >- Cadastro, preço, estoque, variações e variantes de produto no módulo de Compras da v2. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. - name: Mix de produtos description: >- Sortimento de produtos por empresa. Disponível apenas quando o recurso de mix está habilitado na plataforma, em Comercial > Configuração > Mix de produto. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. - name: Pedidos e etapas description: >- Pedidos de compra da v2 e o fluxo de etapas, que é configurável por operação. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. - name: Comunicados description: >- Comunicados publicados na plataforma, com o público de cada um, a confirmação de leitura e o conteúdo publicado. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. - name: Chamados description: >- Chamados da plataforma: abertura, timeline, interações, apoios, etiquetas, prazo e conclusão. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. - name: Checklist description: >- Avaliações de checklist com respostas, check-in e check-out, os modelos com seções e questões, e os planos de ação com a timeline. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado por um administrador na plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por segundo, por IP. paths: /api/v2/chamados/ticket/list: get: tags: - Chamados summary: Listar chamados description: >- Lista os chamados da plataforma, com solicitante, responsável, unidade, departamento de destino, assunto, apoios, etiquetas, prazos e situação. Sem o filtro `status`, a resposta traz só os chamados em aberto (`NEW`, `IN_PROGRESS`, `AWAITING_REQUESTER` e `AWAITING_ASSIGNEE`): para ver resolvidos e concluídos, informe `RESOLVED` ou `CLOSED` em `status`. Cada página traz até 100 chamados. operationId: listarChamadosV2 parameters: - name: id in: query schema: type: integer description: Código do chamado. example: 4127 - name: status in: query schema: type: string pattern: >- ^(NEW|IN_PROGRESS|AWAITING_REQUESTER|AWAITING_ASSIGNEE|RESOLVED|CLOSED)(,(NEW|IN_PROGRESS|AWAITING_REQUESTER|AWAITING_ASSIGNEE|RESOLVED|CLOSED))*$ default: NEW,IN_PROGRESS,AWAITING_REQUESTER,AWAITING_ASSIGNEE description: >- Situação do chamado. Para filtrar por mais de uma, separe os valores por vírgula (`status=NEW,IN_PROGRESS`). Sem o filtro, a resposta traz `NEW`, `IN_PROGRESS`, `AWAITING_REQUESTER` e `AWAITING_ASSIGNEE`. | Valor | Significado | | ----- | ----------- | | `NEW` | Novo | | `IN_PROGRESS` | Em andamento | | `AWAITING_REQUESTER` | Aguardando solicitante | | `AWAITING_ASSIGNEE` | Aguardando responsável | | `RESOLVED` | Resolvido | | `CLOSED` | Concluído | example: NEW,IN_PROGRESS - name: direction in: query schema: type: string enum: - ADMIN_TO_ADMIN - COMPANY_TO_ADMIN - ADMIN_TO_COMPANY description: |- Direção do chamado. | Valor | Significado | | ----- | ----------- | | `ADMIN_TO_ADMIN` | Administrador para administrador | | `COMPANY_TO_ADMIN` | Unidade para administrador | | `ADMIN_TO_COMPANY` | Administrador para unidade | example: COMPANY_TO_ADMIN - name: requesterUserId in: query schema: type: integer description: Código do usuário solicitante. example: 63 - name: assigneeUserId in: query schema: type: integer description: Código do usuário responsável. example: 55 - name: companyId in: query schema: type: integer description: Código da unidade. example: 12 - name: categoryId in: query schema: type: integer description: Código do assunto. example: 23 - name: openedAfter in: query schema: type: string format: date-time description: Traz os chamados abertos nesta data ou depois dela, em UTC ISO 8601. example: '2026-10-01T03:00:00Z' - name: openedBefore in: query schema: type: string format: date-time description: Traz os chamados abertos nesta data ou antes dela, em UTC ISO 8601. example: '2026-10-08T02:59:59Z' - name: resolvedAfter in: query schema: type: string format: date-time description: >- Traz os chamados resolvidos nesta data ou depois dela, em UTC ISO 8601. example: '2026-10-02T03:00:00Z' - name: resolvedBefore in: query schema: type: string format: date-time description: >- Traz os chamados resolvidos nesta data ou antes dela, em UTC ISO 8601. example: '2026-10-09T02:59:59Z' - name: closedAfter in: query schema: type: string format: date-time description: >- Traz os chamados concluídos nesta data ou depois dela, em UTC ISO 8601. example: '2026-10-03T03:00:00Z' - name: closedBefore in: query schema: type: string format: date-time description: >- Traz os chamados concluídos nesta data ou antes dela, em UTC ISO 8601. example: '2026-10-10T02:59:59Z' - name: lastUpdatedAfter in: query schema: type: string format: date-time description: >- Traz os chamados atualizados nesta data ou depois dela, em UTC ISO 8601. example: '2026-10-06T12:00:00Z' - name: lastUpdatedBefore in: query schema: type: string format: date-time description: >- Traz os chamados atualizados nesta data ou antes dela, em UTC ISO 8601. example: '2026-10-13T12:00:00Z' - $ref: '#/components/parameters/Page' responses: '200': description: Lista de chamados. content: application/json: schema: type: array items: $ref: '#/components/schemas/ChamadoV2' example: - id: 4127 subject: Forno combinado sem aquecer requesterUser: id: 63 name: Juliana Prado assigneeUser: id: 55 name: Carlos Mendes company: id: 12 name: Sabor Mineiro Savassi inboundDepartment: id: 4 name: Manutenção category: id: 23 name: Equipamento com defeito collaborators: [] tags: [] direction: COMPANY_TO_ADMIN openedAt: '2026-10-05T12:10:27Z' originalDueDate: '2026-10-07T21:00:00Z' dueDate: '2026-10-08T21:00:00Z' firstResponseAt: '2026-10-05T12:48:03Z' lastUpdatedAt: '2026-10-06T15:22:41Z' status: IN_PROGRESS type: STANDARD '400': $ref: '#/components/responses/ErroValidacao' '401': $ref: '#/components/responses/TokenInvalido' '404': $ref: '#/components/responses/NaoEncontrado' '429': $ref: '#/components/responses/LimiteDeRequisicoes' 5XX: $ref: '#/components/responses/ErroDoServidor' components: parameters: Page: name: page in: query description: >- Número da página da listagem, começando em `0`. Incremente até a resposta vir vazia. schema: type: integer minimum: 0 default: 0 example: 0 schemas: ChamadoV2: type: object description: Chamado da plataforma. properties: id: type: integer description: Código do chamado. example: 4127 subject: type: string description: Título do chamado. example: Forno combinado sem aquecer requesterUser: $ref: '#/components/schemas/ChamadoUsuarioV2' description: Solicitante do chamado. assigneeUser: $ref: '#/components/schemas/ChamadoUsuarioV2' description: Responsável pelo atendimento do chamado. company: $ref: '#/components/schemas/ChamadoUnidadeV2' description: Unidade do chamado. inboundDepartment: $ref: '#/components/schemas/ChamadoDepartamentoV2' description: Departamento de destino do chamado. category: $ref: '#/components/schemas/ChamadoAssuntoV2' description: Assunto do chamado. collaborators: type: array description: >- Apoios do chamado. O formato de cada item na listagem ainda não está documentado; na timeline, o apoio aparece no campo `collaborator` dos eventos de apoio. items: type: object example: [] tags: type: array description: >- Etiquetas do chamado. O formato de cada item ainda não está documentado. items: type: object example: [] direction: $ref: '#/components/schemas/DirecaoChamadoV2' description: Direção do chamado. openedAt: type: string format: date-time description: Data de abertura, em UTC ISO 8601. example: '2026-10-05T12:10:27Z' originalDueDate: type: string format: date-time description: Prazo original do chamado, em UTC ISO 8601. example: '2026-10-07T21:00:00Z' dueDate: type: string format: date-time description: Prazo atual do chamado, em UTC ISO 8601. example: '2026-10-08T21:00:00Z' firstResponseAt: type: string format: date-time description: Data da primeira resposta, em UTC ISO 8601. example: '2026-10-05T12:48:03Z' lastUpdatedAt: type: string format: date-time description: Data da última atualização, em UTC ISO 8601. example: '2026-10-06T15:22:41Z' status: $ref: '#/components/schemas/SituacaoChamadoV2' description: Situação do chamado. type: type: string enum: - STANDARD - BROADCAST - MODULE_EXPANSAO_DEAL - MODULE_IMPLANTACAO_PROJECT - MODULE_IMPLANTACAO_PROJECT_TASK - MODULE_PROJETOS_PROJECT - MODULE_PROJETOS_PROJECT_TASK - MODULE_HELPDESK_CHAT description: >- Origem do chamado. | Valor | Significado | | ----- | ----------- | | `STANDARD` | Padrão | | `BROADCAST` | Chamado em massa | | `MODULE_EXPANSAO_DEAL` | Criado a partir de um negócio do módulo Expansão | | `MODULE_IMPLANTACAO_PROJECT` | Criado a partir de um projeto do módulo Implantação | | `MODULE_IMPLANTACAO_PROJECT_TASK` | Criado a partir de uma tarefa de projeto do módulo Implantação | | `MODULE_PROJETOS_PROJECT` | Criado a partir de um projeto do módulo Projetos | | `MODULE_PROJETOS_PROJECT_TASK` | Criado a partir de uma tarefa de projeto do módulo Projetos | | `MODULE_HELPDESK_CHAT` | Criado a partir do módulo Helpdesk | example: STANDARD ChamadoUsuarioV2: type: object description: Usuário em forma resumida. properties: id: type: integer description: Código do usuário. example: 63 name: type: string description: Nome do usuário. example: Juliana Prado ChamadoUnidadeV2: type: object description: Unidade do chamado. properties: id: type: integer description: Código da unidade. example: 12 name: type: string description: Nome da unidade. example: Sabor Mineiro Savassi ChamadoDepartamentoV2: type: object description: Departamento em forma resumida. properties: id: type: integer description: Código do departamento. example: 4 name: type: string description: Nome do departamento. example: Manutenção ChamadoAssuntoV2: type: object description: Assunto do chamado. properties: id: type: integer description: Código do assunto. example: 23 name: type: string description: Nome do assunto. example: Equipamento com defeito DirecaoChamadoV2: type: string enum: - ADMIN_TO_ADMIN - COMPANY_TO_ADMIN - ADMIN_TO_COMPANY description: |- Direção do chamado: quem abre e quem atende. | Valor | Significado | | ----- | ----------- | | `ADMIN_TO_ADMIN` | Administrador para administrador | | `COMPANY_TO_ADMIN` | Unidade para administrador | | `ADMIN_TO_COMPANY` | Administrador para unidade | example: COMPANY_TO_ADMIN SituacaoChamadoV2: type: string enum: - NEW - IN_PROGRESS - AWAITING_REQUESTER - AWAITING_ASSIGNEE - RESOLVED - CLOSED description: |- Situação do chamado. | Valor | Significado | | ----- | ----------- | | `NEW` | Novo | | `IN_PROGRESS` | Em andamento | | `AWAITING_REQUESTER` | Aguardando solicitante | | `AWAITING_ASSIGNEE` | Aguardando responsável | | `RESOLVED` | Resolvido | | `CLOSED` | Concluído | example: IN_PROGRESS Erro: type: object description: >- Corpo padrão de erro da API. Não existe código de erro interno: decida a sua lógica pelo status HTTP e use a mensagem apenas para logs e diagnóstico. required: - error properties: error: type: string description: >- Mensagem legível, em português, descrevendo a falha. O texto pode mudar: nunca o use como condição de código. example: Campo supplierId não pode ser vazio ou nulo. responses: ErroValidacao: description: >- Erro de validação ou formato errado nos dados de entrada. A API aponta **um campo por vez**: corrija o campo indicado na mensagem, reenvie e repita até o 200. content: application/json: schema: $ref: '#/components/schemas/Erro' example: error: Campo supplierId não pode ser vazio ou nulo. TokenInvalido: description: >- Token ausente ou inválido. Confira: copiado por completo, cabeçalho `Authorization` com o nome exato, valor sem o prefixo `Bearer` e gerado na **Gestão de Tokens v2** (tokens v1 não funcionam aqui). Sem retry automático. O corpo real é `{"error": "Acesso não autorizado."}`. content: application/json: schema: $ref: '#/components/schemas/Erro' example: error: Acesso não autorizado. NaoEncontrado: description: >- Recurso inexistente, ou recurso condicionado desabilitado (por exemplo, endpoints de Mix sem o recurso de mix habilitado na operação). Reenviar sem corrigir devolve o mesmo erro. content: application/json: schema: $ref: '#/components/schemas/Erro' LimiteDeRequisicoes: description: >- Limite de requisições excedido: **2 requisições por segundo, por IP**. A resposta é a página HTML padrão do servidor, não JSON, e não há o header `Retry-After`: trate pelo status 429, sem fazer parse do corpo, com espera crescente a partir de 1 segundo. content: text/html: schema: type: string description: >- Página HTML padrão do servidor. Não faça parse; decida pelo status. ErroDoServidor: description: >- Falha inesperada do servidor (raro). Repita com espera crescente; persistindo, acione o suporte com data, hora e endpoint. content: application/json: schema: $ref: '#/components/schemas/Erro' securitySchemes: apiKeyAuth: type: apiKey in: header name: Authorization description: >- Token gerado na Gestão de Tokens v2 do SULTS. Deve ser enviado no cabeçalho `Authorization` de todas as requisições. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.