Skip to main content
GET
https://api.owem.com.br
/
v4
/
i
/
bank-accounts
/
{accountId}
/
balance
Check Balance
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
  }
}

​
Purpose

This endpoint allows you to check your Owem account balance.

​
Authentication

​
Authorization
string
required
Basic Auth required in format: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
accountId
string
required
Owem account identifier.

​
Response

​
requestId
string
UUID for tracking
​
success
boolean
Operation status
​
size
number
Number of items
​
message
string
Descriptive message
​
data
object
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "success": true,
  "size": 1,
  "message": "Saldo consultado",
  "data": {
    "accountId": "123456789000",
    "balance": 1250.75
  }
}

​
Status Codes

HTTPDescription
200Success
400Malformed accountId
401Invalid credentials
403IP not allowlisted
404Account not found
429Rate limit exceeded
500Internal error
For reconciliation and auditing, use the Ledger (GET /v4/i/ledger).