Skip to main content
GET
/
v4
/
i
/
baas
/
accounts
/
{accountId}
/
balance
curl -X GET https://api.owem.com.br/v4/i/baas/accounts/123456789012/balance \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)"

{
  "requestId": "75fc820b-6e1a-4c3e-bb79-a0a0f1bc7e44",
  "success": true,
  "size": 1,
  "data": {
    "accountId": "123456789012",
    "accountNumber": "123456789012",
    "branchCode": "0001",
    "bankCode": "535",
    "balance": 0,
    "currency": "BRL"
  }
}

curl -X GET https://api.owem.com.br/v4/i/baas/accounts/123456789012/balance \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)"

​
Descrição

Consulta o saldo atual de uma conta bancária criada via BaaS. O saldo é retornado em tempo real.
PROGRAMA BETA - Este endpoint está disponível apenas para parceiros aprovados no programa BAAS.

​
Autenticação

Este endpoint usa Basic Auth com sua API Key + Secret. O scope baas:accounts é configurado pela Owem na sua API Key.
Authorization: Basic {Base64(API_KEY:API_SECRET)}

​
Request

​
Headers

HeaderTipoObrigatórioDescrição
Authorizationstring✅Basic Auth (API Key + Secret em Base64)

​
Path Parameters

ParâmetroTipoObrigatórioDescrição
accountIdstring✅ID da conta (retornado em onboarding/status)

​
Response

​
Sucesso (200 OK)

{
  "requestId": "75fc820b-6e1a-4c3e-bb79-a0a0f1bc7e44",
  "success": true,
  "size": 1,
  "data": {
    "accountId": "123456789012",
    "accountNumber": "123456789012",
    "branchCode": "0001",
    "bankCode": "535",
    "balance": 1500.5,
    "currency": "BRL"
  }
}

​
Campos da Response

CampoTipoDescrição
accountIdstringID da conta
accountNumberstringNúmero da conta
branchCodestringCódigo da agência (sempre “0001”)
bankCodestringCódigo do banco (535 = Owem Pay)
balancenumberSaldo atual em reais
currencystringMoeda (sempre “BRL”)

​
Erros

CódigoDescrição
403Conta não pertence a este parceiro
404Conta não encontrada
O saldo retornado é o saldo disponível para operações. Valores bloqueados por MEDs ou estornos não são incluídos.
{
  "requestId": "75fc820b-6e1a-4c3e-bb79-a0a0f1bc7e44",
  "success": true,
  "size": 1,
  "data": {
    "accountId": "123456789012",
    "accountNumber": "123456789012",
    "branchCode": "0001",
    "bankCode": "535",
    "balance": 0,
    "currency": "BRL"
  }
}