# Resumo de chargebacks

**Área:** Chargebacks

Totais dos chargebacks da conta, com os mesmos filtros da listagem.

`GET /v1/disputes/summary`

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

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

- `total` e `openCount`: quantidade de casos, e quantos seguem abertos (`DISPUTE` ou `REFUND_PENDING`).
- `totalAmount`, `totalOpenAmount` e `totalClosedAmount`: valores contestados em reais, no total, em aberto e encerrados.
- `byStatus`: contagem por status. Só aparecem os status que têm casos.

Case de uso:
_Como lojista, quero ver quanto está em disputa no mês, para provisionar o valor que pode ser debitado._

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `type` | **sim** | sempre CHARGEBACK nesta seção |
| `status` | não | DISPUTE, REFUND_PENDING, DISPUTE_CLOSED ou CHARGED_BACK |
| `dateFrom` | não | abertos a partir deste instante, em ISO 8601 (2026-10-01T00:00:00.000Z) |
| `dateTo` | não | abertos até este instante, em ISO 8601 com hora (2026-10-31T23:59:59.999Z). Só a data deixa de fora os casos abertos nesse dia |
| `chargeId` | não | só os chargebacks desta cobrança |
| `search` | não | busca por caseId, chargeId ou transactionId |

### Resposta 200: Sucesso

```json
{
    "type": "CHARGEBACK",
    "total": 4,
    "openCount": 2,
    "totalAmount": 1043.8,
    "totalOpenAmount": 594.0,
    "totalClosedAmount": 449.8,
    "byStatus": {
        "DISPUTE": 2,
        "DISPUTE_CLOSED": 1,
        "CHARGED_BACK": 1
    }
}
```


### 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-resumo-de-chargebacks  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json