> ## 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 v1 do SULTS > Lista os chamados criados na plataforma do SULTS. A busca é **paginada** e limitada a **100 registros** por página. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/chamado/ticket openapi: 3.1.0 info: title: API SULTS version: v1 description: >- API REST do SULTS. Todas as chamadas devem ser autenticadas por um token enviado, puro e sem o prefixo `Bearer`, no cabeçalho HTTP `Authorization`. As datas seguem o formato UTC ISO 8601 (`yyyy-MM-ddTHH:mm:ssZ`) e campos com máscara (CNPJ, telefone, CEP etc.) são retornados sem máscara. Endpoints de listagem paginados aceitam os parâmetros `start` e `limit`. contact: name: Suporte SULTS url: https://ajuda.sults.com.br servers: - url: https://api.sults.com.br description: Produção security: - apiKeyAuth: [] tags: - name: Unidades description: >- Unidades da rede e colaboradores ativos cadastrados no SULTS. Somente leitura: a API não grava unidades nem colaboradores. 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 v1. O limite é de 2 requisições por segundo, por IP. - name: Chamados description: >- Chamados abertos na plataforma e a timeline de cada um, com os endpoints de criação 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 v1. O limite é de 2 requisições por segundo, por IP. - name: Checklist description: >- Avaliações de checklist aplicadas nas unidades, com respostas, check-ins, check-outs e planos de açã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 v1. O limite é de 2 requisições por segundo, por IP. - name: Compras description: >- Pedidos de compra e catálogo de produtos da v1, incluindo o cadastro e a edição de produto e a edição de pedido. A v1 de Compras não recebe novas funcionalidades: mix de produtos, etapas de pedido e as próximas novidades do módulo estão só na API v2, que é a indicada para integrações novas de Compras. 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 v1. O limite é de 2 requisições por segundo, por IP. - name: implantacao description: >- Projetos de implantação de novas unidades e as tarefas de cada projeto. 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 v1. O limite é de 2 requisições por segundo, por IP. x-group: Implantação - name: Projetos description: >- Projetos da operação e as tarefas vinculadas a eles. 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 v1. O limite é de 2 requisições por segundo, por IP. - name: expansao description: >- Negócios do funil de Expansão e a timeline de cada um, com o endpoint de criação de negócio. 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 v1. O limite é de 2 requisições por segundo, por IP. x-group: Expansão paths: /api/v1/chamado/ticket: get: tags: - Chamados summary: Listar chamados description: >- Lista os chamados criados na plataforma do SULTS. A busca é **paginada** e limitada a **100 registros** por página. operationId: listarChamados parameters: - $ref: '#/components/parameters/Start' - $ref: '#/components/parameters/Limit' - name: id in: query required: false description: Código do chamado schema: type: integer example: 1 - name: situacao in: query required: false description: |- Situação atual do chamado. | Valor | Significado | | ----- | ----------- | | 1 | Novo Chamado | | 2 | Concluído | | 3 | Resolvido | | 4 | Em Andamento | | 5 | Aguardando Solicitante | | 6 | Aguardando Responsável | schema: type: integer enum: - 1 - 2 - 3 - 4 - 5 - 6 example: 4 - name: solicitante in: query required: false description: Código do solicitante do chamado schema: type: integer example: 21 - name: tipo in: query required: false description: |- Tipo do chamado. | Valor | Significado | | ----- | ----------- | | 1 | De administrador para administrador | | 2 | De unidade para administrador | | 3 | De administrador para unidade | schema: type: integer enum: - 1 - 2 - 3 example: 1 - name: responsavel in: query required: false description: >- Código da pessoa responsável pelo chamado. Observação: para chamados em fila esse campo não é presente. schema: type: integer example: 8 - name: unidade in: query required: false description: Código da empresa de destino do chamado schema: type: integer example: 12 - name: departamento in: query required: false description: Código do departamento de destino do chamado schema: type: integer example: 2 - name: assunto in: query required: false description: Código do assunto do departamento de destino do chamado schema: type: integer example: 7 - name: abertoStart in: query required: false description: Busca os chamados abertos a partir da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-01T00:00:00Z' - name: abertoEnd in: query required: false description: Busca os chamados abertos antes da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-31T23:59:59Z' - name: concluidoStart in: query required: false description: >- Busca os chamados concluídos a partir da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-01T00:00:00Z' - name: concluidoEnd in: query required: false description: Busca os chamados concluídos antes da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-31T23:59:59Z' - name: resolvidoStart in: query required: false description: >- Busca os chamados resolvidos a partir da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-01T00:00:00Z' - name: resolvidoEnd in: query required: false description: Busca os chamados resolvidos antes da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-31T23:59:59Z' - name: ultimaAlteracaoStart in: query required: false description: >- Busca os chamados com última alteração a partir da data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-01T00:00:00Z' - name: ultimaAlteracaoEnd in: query required: false description: >- Busca os chamados com última alteração anterior à data informada (UTC ISO 8601). schema: type: string format: date-time example: '2026-07-31T23:59:59Z' responses: '200': description: Lista paginada de chamados content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Chamado' start: type: integer description: Página retornada limit: type: integer description: Registros por página totalPage: type: integer description: Quantidade de páginas disponíveis size: type: integer description: Quantidade de registros na página '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: Start: name: start in: query description: >- Número da página da listagem, começando em `0`. Incremente até a resposta vir vazia ou até atingir `totalPage`. schema: type: integer minimum: 0 default: 0 example: 0 Limit: name: limit in: query description: Quantidade de registros por página. O máximo aceito pela API é `100`. schema: type: integer minimum: 1 maximum: 100 default: 100 example: 100 schemas: Chamado: type: object properties: id: type: integer description: Código do chamado example: 1 titulo: type: string description: Título do chamado example: Nova unidade em Belo Horizonte solicitante: type: object description: Pessoa que fez a solicitação do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Juliana Prado responsavel: type: object description: Pessoa responsável pelo atendimento do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Carlos Mendes unidade: type: object description: Empresa de destino do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Sabor Mineiro Savassi departamento: type: object description: Departamento ao qual o chamado foi solicitado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Suporte ao Franqueado departamentoEnvio: type: object description: Departamento de envio do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Operações assunto: type: object description: Assunto do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Equipamento com defeito etiqueta: type: array description: Etiquetas adicionadas ao chamado items: type: object properties: id: type: integer description: Código da etiqueta example: 1 nome: type: string description: Nome da etiqueta example: Urgente cor: type: string description: Cor da etiqueta (hex) example: Verde apoio: type: array items: $ref: '#/components/schemas/ChamadoApoio' description: Pessoas adicionadas como apoio para o atendimento do chamado tipo: type: integer enum: - 1 - 2 - 3 description: |- Tipo do chamado, indicando a origem e o destino. | Valor | Significado | |-------|-------------| | 1 | Admin para admin | | 2 | Unidade para admin | | 3 | Admin para unidade | example: 1 aberto: type: string format: date-time description: Data em que o chamado foi aberto (UTC ISO 8601) example: '2026-09-14T13:05:12Z' resolvido: type: string format: date-time description: Data em que o chamado foi marcado como resolvido example: '2026-09-15T17:22:09Z' concluido: type: string format: date-time description: Data em que o chamado foi marcado como concluído example: '2026-09-15T19:03:47Z' resolverPlanejado: type: string format: date-time description: Data inicialmente planejada para resolver o chamado example: '2026-09-16T21:00:00Z' resolverEstipulado: type: string format: date-time description: Prazo atual para resolver o chamado example: '2026-09-17T21:00:00Z' avaliacaoNota: type: integer description: Nota de avaliação do atendimento do chamado example: 5 avaliacaoObservacao: type: string description: Comentário da avaliação do atendimento do chamado example: Atendimento resolvido dentro do prazo. situacao: type: integer enum: - 1 - 2 - 3 - 4 - 5 - 6 description: |- Situação do chamado. | Valor | Significado | |-------|-------------| | 1 | Novo | | 2 | Concluído | | 3 | Resolvido | | 4 | Em andamento | | 5 | Aguardando solicitante | | 6 | Aguardando responsável | example: 1 primeiraInteracao: type: string format: date-time description: Data da primeira interação do responsável no chamado example: '2026-09-14T13:41:30Z' ultimaAlteracao: type: string format: date-time description: Data da última alteração no chamado example: '2026-09-15T19:03:47Z' countInteracaoPublico: type: integer description: Quantidade de interações públicas do chamado example: 1 countInteracaoInterno: type: integer description: Quantidade de interações privadas do chamado example: 1 ChamadoApoio: type: object properties: pessoa: type: object description: Pessoa de suporte como apoio no atendimento do chamado properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Bruno Almeida departamento: type: object description: Departamento da pessoa adicionada como apoio properties: id: type: integer description: Código example: 1 nome: type: string description: Nome example: Manutenção pessoaUnidade: type: boolean description: >- `true`: a pessoa desse apoio é um colaborador da unidade do chamado. `false`: a pessoa desse apoio é um administrador da empresa principal. example: true 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 responsavel 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 responsavel 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 v1** (tokens v2 não funcionam nesta API). 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 ou entidade inexistente (por exemplo, um `{id}` do caminho que não existe ou foi excluído no SULTS). 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 através do sistema 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.