> ## 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 checkout de uma avaliação na API v2 do SULTS

> Retorna o check-out de uma avaliação: data, navegador ou aplicativo usado, comentário, localização, assinaturas, anexos e as pessoas com quem o resultado foi compartilhado. Apesar do `/list` no caminho, a resposta é um objeto único, não um array, e não há paginação. O parâmetro `assessmentId` é obrigatório.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /api/v2/checklist/assessment/checkout/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/checkout/list:
    get:
      tags:
        - Checklist
      summary: Listar checkout de uma avaliação
      description: >-
        Retorna o check-out de uma avaliação: data, navegador ou aplicativo
        usado, comentário, localização, assinaturas, anexos e as pessoas com
        quem o resultado foi compartilhado. Apesar do `/list` no caminho, a
        resposta é um objeto único, não um array, e não há paginação. O
        parâmetro `assessmentId` é obrigatório.
      operationId: listarCheckoutAvaliacaoV2
      parameters:
        - name: assessmentId
          in: query
          required: true
          schema:
            type: integer
          description: Código da avaliação.
          example: 1201
      responses:
        '200':
          description: Check-out da avaliação.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvaliacaoCheckoutV2'
              example:
                id: 136
                checkedOutAt: '2026-10-06T14:42:18Z'
                userAgent: >-
                  Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML,
                  like Gecko) Chrome/129.0.0.0 Mobile Safari/537.36
                comment: Inspeção concluída com a gerente.
                geolocation:
                  latitude: -19.9385
                  longitude: -43.9349
                  accuracy: 12.5
                  capturedAt: '2026-10-06T14:41:55Z'
                signatures:
                  - name: Juliana Prado
                    jobTitle: Gerente da unidade
                    base64: PD94bWwgdmVyc2lvbj0iMS4wIj8+...
                    mimeType: image/svg+xml
                    signedAt: '2026-10-06T14:41:30Z'
                attachments:
                  - name: relatorio-assinado.jpg
                    url: https://link/relatorio-assinado.jpg
                    fileLength: 3949
                  - name: uplod-empty.txt
                    url: >-
                      https://sults-bucket.s3.amazonaws.com/treinamento/ChecklistPlanoAcaoInteracao/220/uplod-empty.txt
                    fileLength: 6
                sharedWith:
                  - name: Juliana Prado
                    email: juliana.prado@sabormineiro.com.br
        '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:
  schemas:
    AvaliacaoCheckoutV2:
      type: object
      description: Check-out de uma avaliação.
      properties:
        id:
          type: integer
          description: Código do check-out.
          example: 136
        checkedOutAt:
          type:
            - string
            - 'null'
          description: Data do check-out, em UTC ISO 8601.
          example: '2026-10-06T14:42:18Z'
          format: date-time
        userAgent:
          type:
            - string
            - 'null'
          description: Navegador ou aplicativo usado no check-out.
          example: >-
            Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like
            Gecko) Chrome/129.0.0.0 Mobile Safari/537.36
        comment:
          type:
            - string
            - 'null'
          description: Comentário do check-out.
          example: Inspeção concluída com a gerente.
        geolocation:
          $ref: '#/components/schemas/ChecklistGeolocalizacaoV2'
          description: Localização do check-out.
        signatures:
          type: array
          description: Assinaturas do check-out.
          items:
            $ref: '#/components/schemas/ChecklistAssinaturaV2'
        attachments:
          type: array
          description: Anexos do check-out.
          items:
            $ref: '#/components/schemas/ChecklistAnexoV2'
        sharedWith:
          type: array
          description: Pessoas com quem o resultado foi compartilhado.
          items:
            $ref: '#/components/schemas/ChecklistCompartilhamentoV2'
    ChecklistGeolocalizacaoV2:
      type: object
      description: Localização capturada no check-in ou no check-out.
      properties:
        latitude:
          type:
            - number
            - 'null'
          description: Latitude.
          example: -19.9385
        longitude:
          type:
            - number
            - 'null'
          description: Longitude.
          example: -43.9349
        accuracy:
          type:
            - number
            - 'null'
          description: Precisão da localização.
          example: 12.5
        capturedAt:
          type:
            - string
            - 'null'
          description: Data da captura da localização, em UTC ISO 8601.
          example: '2026-10-06T12:58:40Z'
          format: date-time
    ChecklistAssinaturaV2:
      type: object
      description: Assinatura coletada no check-in ou no check-out.
      properties:
        name:
          type: string
          description: Nome de quem assinou.
          example: Juliana Prado
        jobTitle:
          type: string
          description: Cargo de quem assinou.
          example: Gerente da unidade
        base64:
          type: string
          description: Imagem da assinatura em Base64.
          example: PD94bWwgdmVyc2lvbj0iMS4wIj8+...
        mimeType:
          type: string
          description: Tipo da imagem da assinatura.
          example: image/svg+xml
        signedAt:
          type: string
          description: Data da assinatura, em UTC ISO 8601.
          example: '2026-10-06T12:59:12Z'
          format: date-time
    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
    ChecklistCompartilhamentoV2:
      type: object
      description: Pessoa com quem o resultado foi compartilhado no check-out.
      properties:
        name:
          type: string
          description: Nome da pessoa.
          example: Juliana Prado
        email:
          type: string
          description: E-mail da pessoa.
          example: juliana.prado@sabormineiro.com.br
    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.