# Consultar chargeback

**Área:** Chargebacks

Detalhe de um chargeback: os mesmos campos da listagem, mais `evidence`, a defesa com os anexos.

`GET /v1/disputes/:caseId`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

**Scopes necessários:** `charges/read`

**`evidence`**

- `status`: `DRAFT` ou `SUBMITTED`.
- `description`: o texto da defesa. `null` até o envio.
- `attachments`: arquivos anexados, com `fileId` para baixar ou remover.
- `submission`: andamento depois do envio — `status` (`PENDING`, `IN_REVIEW`, `SENT`, `REJECTED`, `RESOLVED`), `sentAt` e `protocol`, o número de protocolo da contestação quando houver. `null` antes do envio.

Chargeback de outra conta responde `404 CHARGEBACK_CASE_NOT_FOUND`, igual a um ID inexistente.

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `caseId` | **sim** | Identificador do chargeback (`caseId`), devolvido na listagem |

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `type` | **sim** | sempre CHARGEBACK nesta seção |

### Resposta 200: Sucesso

```json
{
    "caseId": "cbk_1790512345678_k3m9q2xwz",
    "type": "CHARGEBACK",
    "status": "DISPUTE",
    "accountId": "460851686",
    "chargeId": "cha_1790012345678_a8f2k1pqz",
    "transactionId": "a1b2c3d4-0000-0000-0000-000000000000",
    "amount": 297.0,
    "originalAmount": 297.0,
    "currency": "BRL",
    "installments": 1,
    "openedAt": "2026-10-20T13:05:41.000Z",
    "updatedAt": "2026-10-20T13:05:41.000Z",
    "closedAt": null,
    "evidenceStatus": "SUBMITTED",
    "evidenceSubmittedAt": "2026-10-21T10:15:27.000Z",
    "evidenceAttachmentCount": 1,
    "submissionStatus": "PENDING",
    "evidence": {
        "description": "Produto entregue em 02/10/2026, conforme comprovante assinado pelo comprador.",
        "status": "SUBMITTED",
        "submittedAt": "2026-10-21T10:15:27.000Z",
        "attachments": [
            {
                "fileId": "evd_1790598765432_r7t2n5vbc",
                "fileName": "comprovante-entrega.pdf",
                "contentType": "application/pdf",
                "size": 184320,
                "uploadedAt": "2026-10-21T10:12:03.000Z"
            }
        ],
        "submission": {
            "status": "PENDING",
            "sentAt": null,
            "protocol": null
        }
    },
    "charge": {
        "chargeId": "cha_1790012345678_a8f2k1pqz",
        "amount": 297.0,
        "status": "DISPUTE",
        "paymentType": "CREDIT_CARD",
        "customerName": "Maria Souza",
        "customerDocument": "12345678901",
        "customerEmail": "maria@exemplo.com.br",
        "productName": "Plano Pro"
    }
}
```


### Resposta 404: Chargeback não encontrado

```json
{
    "error": {
        "message": "Caso de chargeback não encontrado",
        "code": "CHARGEBACK_CASE_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-28T14:20:00.000Z"
    }
}
```


### Resposta 400: Tipo inválido

```json
{
    "error": {
        "message": "Parâmetro 'type' é obrigatório e deve ser MED, CHARGEBACK ou REFUND",
        "code": "INVALID_DISPUTE_TYPE",
        "details": null,
        "timestamp": "2026-10-28T14:20:00.000Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/get-consultar-chargeback  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json