# Saldo subcontas
`GET /v1/wallet/balance`
**Área:** Subcontas ValidaPay

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

Com esta funcionalidade você pode verificar o saldo de uma ou várias subcontas

> ⚠️ **Atenção:** Para consultar o saldo de várias subcontas envie o header acoountId com o número das subcontas separado por vírgula, por exemplo: 9489623,9489624,9489625

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `accountId` | **sim** | Número da subconta. Para consultar o saldo de várias subcontas envie separado por virgula |

### Resposta 200 — Sucesso

```json
{
    "masterAccountId": "429131313",
    "balances": [
        {
            "accountNumber": "459013888",
            "name": "VALIDAPAY PAGAMENTOS TECNOLOGIA E SERVICOS",
            "balance": 54.81
        },
        {
            "accountNumber": "460851986",
            "name": "VALIDA PIX",
            "balance": 196.82
        }
    ]
}
```

### Resposta 401 — Acesso negado

```json
{
    "error": {
        "message": "Subconta 436514888 nao pertence a esta conta master",
        "code": "UNAUTHORIZED_SUBACCOUNT",
        "details": null,
        "timestamp": "2026-03-17T03:45:53.738Z"
    }
}
```

### Resposta 404 — Subconta não encontrada

```json
{
    "error": {
        "message": "Subconta 459013666 nao encontrada",
        "code": "SUBACCOUNT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-03-17T03:46:49.577Z"
    }
}
```

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