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

# Consultar saldo

> Saldo disponível, a parte das subcontas e o que é só seu, o bloqueado, o que falta cobrir de MED e o valor mínimo do saque.

Escopo `balance:read`. Valores em centavos. O saldo é a posição atual da conta; o histórico está em [Listar movimentações](https://docs.wyzecash.com.br/referencia/extrato/listar-movimentacoes.md).

## Resposta

**available** `integer`

O que pode ser sacado ou enviado agora.

**subaccounts** `integer`

A parte do `available` que é das suas subcontas (soma do saldo atribuído a elas).

**free** `integer`

O que é só seu: `available` menos `subaccounts`. Saque, Pix enviado, transferência e envio para subconta usam só este valor; acima dele, `422 SUBACCOUNT_FUNDS`.

**pending** `integer`

A liberar: vendas no cartão já aprovadas (líquido da tarifa) que entram no disponível na data de cada uma (`availableAt` da cobrança, 15 dias depois da aprovação, D+15).

**blocked** `integer`

Retido por pedidos de devolução (MED) em aberto.

**medOwed** `integer`

MED devolvido sem saldo suficiente: o que ainda falta cobrir. Os próximos recebimentos descontam isso antes de ficar disponível.

**withdrawal** `object`

O valor mínimo do saque da conta.

**propriedades**

**minPerTransaction** `integer`

Menor saque da conta, em centavos. Abaixo dele: `422 BELOW_MINIMUM`.

**updatedAt** `string | null`

Última mudança no saldo (ISO 8601). `null` em conta que nunca movimentou.

```bash cURL theme={null}
curl https://api.wyzecash.com.br/v1/balance \
  -H "Authorization: Bearer bk_live_..."
```

```json 200 theme={null}
{
  "available": 184250,
  "subaccounts": 14200,
  "free": 170050,
  "pending": 0,
  "blocked": 5000,
  "medOwed": 0,
  "withdrawal": { "minPerTransaction": 100 },
  "updatedAt": "2026-10-08T14:58:03.120Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.