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

# Listar documentos do chargeback

> Retorna os documentos de contestação já enviados para um chargeback.

`GET /chargebacks/:id/documents`

Faz parte do recurso [Chargebacks](/pt-BR/chargebacks) — as etapas do caso e a janela de defesa
estão lá.

Retorna o que já foi enviado como prova. A coleção **não pagina**: um caso tem poucos documentos, e
a resposta traz todos em `data`.

<Note>
  **A lista não traz o arquivo, e nem o caminho dele.** Cada item descreve o documento — `type`,
  `contentType`, `size` — e é isso que você usa para saber o que já foi enviado.
  Para obter o conteúdo, use
  [`GET /chargebacks/:id/documents/:documentId/download`](/pt-BR/chargebacks/documents-download),
  que devolve uma URL assinada e temporária.
</Note>

<Note>
  **`type` diz que prova é aquela**, e os valores são fechados: `invoice` (nota fiscal),
  `delivery_proof` (comprovante de entrega), `signed_contract` (contrato assinado), `screenshot`
  (captura de tela) e `other`.
</Note>

<Warning>
  **A lista continua respondendo depois que a janela fecha.** Consultar é sempre possível; o que
  depende de `under_review` e do `deadlineAt` é o
  [envio](/pt-BR/chargebacks/documents-post). Uma lista vazia num caso já julgado significa que nada
  chegou a ser enviado — não que os documentos expiraram.
</Warning>


## OpenAPI

````yaml openapi/psp.json GET /chargebacks/{id}/documents
openapi: 3.0.3
info:
  title: Z2Pay PSP API
  version: 1.0.0
  description: API pública do PSP — autenticação via API Key (Credential)
servers:
  - url: https://api.sandbox.z2pay.com/v1
    description: Sandbox
  - url: https://api.z2pay.com/v1
    description: Produção
security: []
tags:
  - name: Cards
    description: Cartões salvos de um cliente
  - name: Chargebacks
    description: Gerenciamento de chargebacks
  - name: Customers
    description: Gerenciamento de clientes (compradores)
  - name: Fees
    description: Tabela de taxas da conta (pix, boleto, cartão, saque, refund, chargeback)
  - name: Recipients
    description: Gerenciamento de recebedores (sellers/merchants que recebem repasses)
  - name: Refunds
    description: Gerenciamento de reembolsos e estornos
  - name: Splits
    description: Regras de divisão do valor de uma venda entre recebedores
  - name: Transactions
    description: Gerenciamento de transações e payments
  - name: Wallets
    description: Saldo, extrato e resumo da carteira de um recebedor, agrupados por moeda
  - name: Webhooks
    description: Configuração, gerenciamento e histórico de entregas de webhooks
  - name: Withdrawals
    description: Solicitação e acompanhamento de saques (payouts) por recipient
paths:
  /chargebacks/{id}/documents:
    get:
      tags:
        - Chargebacks
      summary: Listar documentos do chargeback
      description: Retorna documentos de contestação enviados.
      operationId: ChargebackController_listDocuments
      parameters:
        - name: id
          in: path
          required: true
          description: ID do chargeback
          schema:
            type: string
      responses:
        '200':
          description: Lista de documentos
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Identificador único do registro.
                        chargebackId:
                          type: string
                          description: ID do chargeback ao qual o registro pertence.
                        type:
                          type: string
                          description: >-
                            Tipo do documento de contestação: `invoice`,
                            `delivery_proof`, `signed_contract`, `screenshot` ou
                            `other`.
                        contentType:
                          type: string
                          description: 'Tipo MIME do arquivo enviado (ex.: application/pdf).'
                        size:
                          type: integer
                          description: Tamanho do arquivo enviado, em bytes.
                        description:
                          type: string
                          nullable: true
                          description: Descrição do registro.
                        createdAt:
                          type: string
                          format: date-time
                          description: Data e hora de criação do registro (ISO 8601).
                        updatedAt:
                          type: string
                          format: date-time
                          description: >-
                            Data e hora da última atualização do registro (ISO
                            8601).
                    description: Lista de registros retornados na página atual.
              example:
                data:
                  - id: cbkd_y4bf4q9kn7nfbksmvfjiwc5ba
                    chargebackId: cbk_v5wylkgvv2rls5tihmuybrz9v
                    type: invoice
                    contentType: application/pdf
                    size: 248512
                    description: Nota fiscal da compra
                    createdAt: '2025-06-30T11:20:00.000Z'
                    updatedAt: '2025-06-30T11:20:00.000Z'
        '401':
          description: Chave de API ausente, malformada ou inválida
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Identificador estável do erro. É por ele que você deve
                          ramificar, não pela mensagem.
                      message:
                        type: string
                        description: >-
                          Descrição legível. Pode mudar sem aviso e não deve ser
                          usada em condicional.
              example:
                error:
                  code: UNAUTHORIZED
                  message: Invalid API key
        '404':
          description: Chargeback não encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Identificador estável do erro. É por ele que você deve
                          ramificar, não pela mensagem.
                      message:
                        type: string
                        description: >-
                          Descrição legível. Pode mudar sem aviso e não deve ser
                          usada em condicional.
              example:
                error:
                  code: NOT_FOUND
                  message: Document not found
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key da Credential (gerada no Backoffice)

````