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

# Listar as provas de um documento

Lista as provas atuais de um documento (arquivos substituídos e excluídos não são incluídos).

Os erros usam `application/problem+json` com um `code` estável. Catálogo completo: [Entity Statuses and Error Codes](https://docs.localpayment.com/pt-br/reference/entity-statuses-and-error-codes.md).


## OpenAPI

````yaml openapi/pt-br/localpayment.json GET /api/entity/v1/documents/{docId}/proofs
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/entity/v1/documents/{docId}/proofs:
    get:
      summary: Listar as provas de um documento
      operationId: list-document-proofs
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token). Sua conta
            de comerciante e o usuário que realiza a ação são identificados a
            partir dele.
          required: true
          schema:
            type: string
            examples:
              - Bearer <your_access_token>
        - name: X-Correlation-ID
          in: header
          description: >-
            Identificador de rastreamento (UUID). Exibido na resposta; gerado
            pelo Localpayment se ausente.
          required: false
          schema:
            type: string
            examples:
              - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
        - name: docId
          in: path
          description: ID do documento.
          required: true
          schema:
            type: string
            format: uuid
            examples:
              - e0ea9515-442e-4bc5-bc82-b8d278255c37
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      examples:
                        - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    documentId:
                      type: string
                      examples:
                        - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                      format: uuid
                    proofType:
                      type: string
                      examples:
                        - FRONT
                      enum:
                        - FRONT
                        - BACK
                        - SELFIE
                        - DOCUMENT
                        - OTHER
                    fileName:
                      type: string
                      examples:
                        - id_front.jpg
                    mimeType:
                      type: string
                      examples:
                        - image/jpeg
                    sizeBytes:
                      type: integer
                      examples:
                        - 102400
                    verificationStatus:
                      type: string
                      examples:
                        - PENDING
                      enum:
                        - PENDING
                        - IN_REVIEW
                        - APPROVED
                        - REJECTED
                    verifiedBy:
                      type:
                        - string
                        - 'null'
                    verifiedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                    verificationReason:
                      type:
                        - string
                        - 'null'
                    uploadedBy:
                      type: string
                      examples:
                        - '12345'
                    uploadedAt:
                      type: string
                      examples:
                        - '2024-01-15T17:03:13Z'
                      format: date-time
                    status:
                      type: string
                      examples:
                        - CURRENT
                      enum:
                        - CURRENT
                        - SUPERSEDED
                        - DELETED
                      description: >-
                        Ciclo de vida da prova: CURRENT (ativa), SUPERSEDED
                        (substituída por um upload mais recente do mesmo
                        proofType) ou DELETED. Independente de
                        verificationStatus.
                    supersededAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                    supersededBy:
                      type:
                        - string
                        - 'null'
                    replacedByProofId:
                      type:
                        - string
                        - 'null'
                      format: uuid
                    deletedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                    deletedBy:
                      type:
                        - string
                        - 'null'
                    inVerification:
                      type: boolean
                      examples:
                        - false
              examples:
                Example 1:
                  value:
                    - id: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                      documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                      proofType: FRONT
                      fileName: id_front.jpg
                      mimeType: image/jpeg
                      sizeBytes: 102400
                      verificationStatus: PENDING
                      verifiedBy: null
                      verifiedAt: null
                      verificationReason: null
                      uploadedBy: '12345'
                      uploadedAt: '2024-01-15T17:03:13Z'
                      status: CURRENT
                      supersededAt: null
                      supersededBy: null
                      replacedByProofId: null
                      deletedAt: null
                      deletedBy: null
                      inVerification: false
        '401':
          description: 'Não autorizado. UNAUTHORIZED: Token de acesso ausente ou inválido.'
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalhes do problema segundo a RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumo do problema.
                  status:
                    type: integer
                    description: Código de status HTTP.
                  detail:
                    type: string
                    description: Explicação em linguagem acessível a humanos.
                  instance:
                    type: string
                    description: Caminho da solicitação.
                  code:
                    type: string
                    description: >-
                      Código de erro estável e legível por máquina. Faça a
                      ramificação da lógica com base nesse valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador da solicitação. Informe-o ao entrar em
                      contato com o suporte.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, quando aplicável.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNAUTHORIZED:
                  value:
                    type: about:blank
                    title: Unauthorized
                    status: 401
                    detail: Missing or invalid access token.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '404':
          description: >-
            Não encontrado. DOCUMENT_NOT_FOUND: O documento não existe, foi
            excluído ou pertence a outro comerciante.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalhes do problema segundo a RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumo do problema.
                  status:
                    type: integer
                    description: Código de status HTTP.
                  detail:
                    type: string
                    description: Explicação em linguagem acessível a humanos.
                  instance:
                    type: string
                    description: Caminho da solicitação.
                  code:
                    type: string
                    description: >-
                      Código de erro estável e legível por máquina. Faça a
                      ramificação da lógica com base nesse valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador da solicitação. Informe-o ao entrar em
                      contato com o suporte.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, quando aplicável.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - DOCUMENT_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: >-
                      The document does not exist, was deleted, or belongs to
                      another merchant.
                    instance: >-
                      /api/entity/v1/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37/proofs
                    code: DOCUMENT_NOT_FOUND
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

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