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.

GET /v1/balance

cURL

curl https://bukio-backend-production.up.railway.app/v1/balance \
  -H "Authorization: Bearer bk_live_..."

200

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

Escopo balance:read. Valores em centavos. O saldo é a posição atual da conta; o histórico está em Listar movimentações.

​

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.

Show 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.

cURL

curl https://bukio-backend-production.up.railway.app/v1/balance \
  -H "Authorization: Bearer bk_live_..."

200

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