# Listar cobranças
`GET /v1/charges`
**Área:** Subcontas ValidaPay

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

Com esta rota você poderá listar todas as cobranças que a sua _master account_ gerou em uma subcontas

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `dateFrom` | não |  |
| `dateTo` | não |  |
| `page` | não |  |
| `perPage` | não |  |

### Resposta 200 — 200

```json
{
    "data": [
        {
            "status": "PENDING",
            "createdAt": "2026-02-23T18:46:22.652Z",
            "chargeId": "cha_1771872382645_qe5j0ohge",
            "updatedAt": "2026-02-23T18:46:22.652Z",
            "masterAccountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
            "amount": 39.9,
            "attempts": 1,
            "emvQrCode": "00020101021226930014br.gov.bcb.pix…",
            "paymentType": "PIX",
            "subAccountId": "4949228"
        },
        {
            "status": "PENDING",
            "createdAt": "2026-02-23T18:34:13.130Z",
            "chargeId": "cha_1771871653130_pzzsyzeha",
            "updatedAt": "2026-02-23T18:34:13.130Z",
            "masterAccountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
            "amount": 39.9,
            "attempts": 1,
            "emvQrCode": "00020101021226930014br.gov.bcb.pix…",
            "paymentType": "PIX",
            "subAccountId": "4949228"
        },
        {
            "status": "PENDING",
            "createdAt": "2026-02-23T18:34:09.892Z",
            "chargeId": "cha_1771871649852_mm0luemzr",
            "updatedAt": "2026-02-23T18:34:09.892Z",
            "masterAccountId": "SANDBOX_0438f4c8-0031-7051-16d4-5a23704756b6",
            "amount": 39.9,
            "attempts": 1,
            "emvQrCode": "00020101021226930014br.gov.bcb.pix…",
            "paymentType": "PIX",
            "subAccountId": "4949228"
        }
    ],
    "totalItems": 23,
    "totalPages": 2,
    "page": 1,
    "limit": 15,
    "dateFrom": "2026-02-01T00:00:00.000Z",
    "dateTo": "2026-02-23T23:59:59.999Z"
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-listar-cobrancas
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json