Saldo

Consultar Saldo

Saldo atual e histórico agregado por período da conta titular.

Objetivo

Posição financeira da conta agora e visão agregada entre duas datas.

Para movimentos linha a linha use Extrato.

Pré-requisito: Login da conta. Scope baas.balances.read.

Consultar (/balances): posição no momento da chamada (valores em centavos na resposta típica). Três campos: balance (disponível), blocked_balance (bloqueado) e reserved_balance (reservado).
Consultar por período (/balances/period): snapshots diários entre start_date e end_date (YYYY-MM-DD). Útil para gráficos, não substitui extrato nem conciliação contábil.
Saldo pontual não prova transação individual.

Contrato HTTP: Consultar saldo.


Método	`GET`
Path	`/api/v2/baas/balances`

Bearer da conta, HMAC. Corpo [] na assinatura.

Três posições: balance (disponível para cash-out e pagamentos), blocked_balance (MED, Pix automático, boleto em processo, etc.) e reserved_balance (retenção contratual sobre Pix cash-in). Reservado não é o mesmo que bloqueado. A reserva reduz o disponível e não entra em cash-out até a devolução operacional (fora desta API).


Método	`GET`
Path	`/api/v2/baas/balances/period`

start_date, end_date obrigatórios (YYYY-MM-DD).

Consultar Extrato

Movimentações financeiras da conta titular em um período.

Sobre o BaaS

Produto BaaS v2: guia passo a passo, ambientes, scopes e separação plataforma vs conta.