> ## 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 respostas de uma avaliação na API v2 do SULTS > Lista as respostas de uma avaliação, uma por questão, com a questão, a seção, o tipo da questão, a pontuação, o comentário, os anexos e os planos de ação gerados pela resposta. A pontuação (`score` e `maxScore`) vem como texto e não vem em avaliação agendada. O parâmetro `assessmentId` é obrigatório. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /api/v2/checklist/assessment/answer/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/checklist/assessment/answer/list: get: tags: - Checklist summary: Listar respostas de uma avaliação description: >- Lista as respostas de uma avaliação, uma por questão, com a questão, a seção, o tipo da questão, a pontuação, o comentário, os anexos e os planos de ação gerados pela resposta. A pontuação (`score` e `maxScore`) vem como texto e não vem em avaliação agendada. O parâmetro `assessmentId` é obrigatório. operationId: listarRespostasAvaliacaoV2 parameters: - name: assessmentId in: query required: true schema: type: integer description: Código da avaliação. example: 1201 - name: sectionId in: query schema: type: integer description: Código da seção do modelo. example: 5132 - name: templateQuestionId in: query schema: type: integer description: >- Código da questão do modelo (o `id` de `templateQuestion` na resposta). example: 2145 - name: notApplicable in: query schema: type: boolean description: Filtra pelas respostas marcadas como não aplicáveis. example: false - $ref: '#/components/parameters/Page' responses: '200': description: Respostas da avaliação. content: application/json: schema: type: array items: $ref: '#/components/schemas/AvaliacaoRespostaV2' example: - id: 694 answerText: Não conforme answerTemplateOptionId: - 5299 templateQuestion: id: 2145 title: Os extintores estão dentro da validade? section: id: 530 name: Segurança type: CONFORMITY score: '0' maxScore: '10' scoreZeroed: false notApplicable: false comment: '' attachments: - name: uplod-empty.txt url: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: 6 actionPlans: - id: 119 what: Recarregar os extintores vencidos whenDate: '2026-10-20' status: NEW - id: 693 answerText: Regular answerTemplateOptionId: - 5297 templateQuestion: id: 2144 title: Qual a qualidade da abordagem ao cliente? section: id: 529 name: Atendimento type: RATING_QUALITY_3 score: '30' maxScore: '60' scoreZeroed: false notApplicable: false comment: '' attachments: - name: uplod-empty.txt url: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: 6 actionPlans: [] - id: 692 answerText: '3' templateQuestion: id: 2143 title: Como você avalia o tempo de espera no caixa? section: id: 529 name: Atendimento type: RATING_STAR_5 score: '42' maxScore: '70' scoreZeroed: false notApplicable: false comment: '' attachments: - name: uplod-empty.txt url: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: 6 actionPlans: [] - id: 691 answerText: Regular answerTemplateOptionId: - 5292 templateQuestion: id: 2142 title: Qual o estado de conservação da vitrine? section: id: 528 name: Fachada e vitrine type: RATING_QUALITY_5 score: '30' maxScore: '50' scoreZeroed: false notApplicable: false comment: '' attachments: - name: uplod-empty.txt url: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: 6 actionPlans: [] - id: 690 answerText: Sim answerTemplateOptionId: - 5289 templateQuestion: id: 2141 title: A fachada está iluminada? section: id: 528 name: Fachada e vitrine type: YES_NO score: '10' maxScore: '10' scoreZeroed: false notApplicable: false comment: '' attachments: - name: uplod-empty.txt url: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: 6 actionPlans: [] '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: AvaliacaoRespostaV2: type: object description: Resposta de uma questão na avaliação. properties: id: type: integer description: Código da resposta. example: 4922 answerText: type: string description: Resposta em texto. example: Bom answerTemplateOptionId: type: array description: >- Códigos das opções escolhidas (o `id` das opções em `typeSettings.option` da listagem de questões do modelo), nas questões de opções. Não vem nos demais tipos. items: type: integer example: - 5299 templateQuestion: $ref: '#/components/schemas/ChecklistQuestaoResumoV2' description: Questão respondida. section: $ref: '#/components/schemas/ChecklistSecaoResumoV2' description: Seção da questão. type: $ref: '#/components/schemas/TipoQuestaoV2' description: Tipo da questão. score: type: string description: >- Pontuação obtida na questão. Vem como texto. Não vem em avaliação agendada. example: '30' maxScore: type: string description: >- Pontuação máxima da questão. Vem como texto. Não vem em avaliação agendada. example: '60' scoreZeroed: type: - boolean - 'null' description: Indica se a pontuação da questão foi zerada. example: false notApplicable: type: boolean description: Indica se a questão foi marcada como não aplicável. example: false comment: type: string description: Comentário da resposta. example: Prateleiras de cima com poeira. attachments: type: array description: Anexos da resposta. items: $ref: '#/components/schemas/ChecklistAnexoV2' actionPlans: type: array description: Planos de ação gerados pela resposta. items: $ref: '#/components/schemas/PlanoAcaoResumoV2' ChecklistQuestaoResumoV2: type: object description: Questão do modelo em forma resumida. properties: id: type: integer description: Código da questão. example: 2145 title: type: string description: Título da questão. example: Os extintores estão dentro da validade? ChecklistSecaoResumoV2: type: object description: Seção do modelo em forma resumida. properties: id: type: integer description: Código da seção. example: 5132 name: type: string description: Nome da seção. example: Estoque seco TipoQuestaoV2: type: string description: >- Tipo da questão. Os mesmos valores vêm nas questões do modelo e nas respostas da avaliação. | Valor | Significado | | ----- | ----------- | | `TEXT_SHORT` | Texto curto | | `TEXT_LONG` | Texto longo | | `CONFORMITY` | Conformidade | | `RATING_STAR_5` | Nível de qualidade em 5 estrelas | | `RATING_QUALITY_5` | Nível de qualidade com 5 opções | | `RATING_QUALITY_3` | Nível de qualidade com 3 opções | | `RATING_NUMERIC_10` | Em confirmação com a engenharia | | `CUSTOM_SINGLE_CHOICE` | Valores personalizados, uma escolha | | `CUSTOM_MULTI_CHOICE` | Valores personalizados, múltipla escolha | | `YES_NO` | Sim ou não | | `DATE` | Data | | `CURRENCY` | Valor monetário | A lista acima traz os valores já confirmados na API; os demais tipos estão em confirmação com a engenharia. example: RATING_QUALITY_3 ChecklistAnexoV2: type: object description: Arquivo anexado. properties: name: type: string description: Nome do arquivo. example: uplod-empty.txt url: type: string description: Endereço para download do arquivo. example: >- https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt fileLength: type: integer description: Tamanho do arquivo em bytes. example: 6 PlanoAcaoResumoV2: type: object description: Plano de ação em forma resumida. properties: id: type: integer description: Código do plano de ação. example: 119 what: type: string description: O que será feito. example: Comprar organizadores para as estantes whenDate: type: string format: date description: >- Prazo do plano de ação, em yyyy-MM-dd. Apesar do nome, traz o mesmo valor de `whenDeadlineDate` da listagem de planos de ação, não o `whenDate` (data de início) de lá. example: '2026-10-20' status: $ref: '#/components/schemas/SituacaoPlanoAcaoV2' description: Situação do plano de ação. 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. SituacaoPlanoAcaoV2: type: string enum: - NEW - RESOLVED - CLOSED - IN_PROGRESS - REJECTED description: |- Situação do plano de ação. | Valor | Significado | | ----- | ----------- | | `NEW` | Novo | | `RESOLVED` | Resolvido | | `CLOSED` | Concluído | | `IN_PROGRESS` | Em andamento | | `REJECTED` | Rejeitado | example: IN_PROGRESS 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.