Pular para o conteúdo principal
GET
https://api.owem.com.br
/
v4
/
i
/
bank-accounts
/
{accountId}
/
balance
Consultar saldo
curl --request GET \
  --url https://api.owem.com.br/v4/i/bank-accounts/{accountId}/balance \
  --header 'Authorization: <authorization>'
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "message": "Saldo consultado",
  "data": {
    "accountId": "123456789000",
    "balance": 1250.75
  }
}

​
Finalidade

Este endpoint permite consultar o saldo da conta na Owem.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
accountId
string
obrigatório
Identificador da conta na Owem.

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de itens
​
message
string
Mensagem descritiva
​
data
object
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "message": "Saldo consultado",
  "data": {
    "accountId": "123456789000",
    "balance": 1250.75
  }
}

​
Códigos de Status

HTTPDescrição
200Sucesso
400accountId malformado
401Credenciais inválidas
403IP não allowlisted
404Conta inexistente
429Rate limit excedido
500Erro interno
Para conciliação e auditoria, use o Ledger (GET /v4/i/ledger).