Conta

Consultar saldo

Consulta o saldo da conta autenticada

Consulta o saldo da conta associada ao token.

Referência API: GET /api/v2/contas/saldo.

Request

GET /api/v2/contas/saldo
Authorization: Bearer {access_token}
Accept: application/json

Sem query params.

Header	Obrigatório	Descrição
`Authorization`	Sim	`Bearer {{access_token}}`
`Accept`	Sim	`application/json`

Scope: contas.saldo.read no login.

curl --location 'https://api-h.nuvende.com.br/api/v2/contas/saldo' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}'

Response 200

{
  "account_id": 271274,
  "balance": "60013016.35",
  "blocked_balance": "0.00",
  "old_balance": "0.00",
  "last_change": "2025-01-02 09:50:25",
  "correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Campo	Tipo	Descrição
`account_id`	integer	Identificador da conta
`balance`	string	Saldo disponível
`blocked_balance`	string	Saldo bloqueado
`old_balance`	string	Saldo anterior
`last_change`	string	Data/hora da última alteração (`Y-m-d H:i:s`)
`correlationId`	string	ID de correlação da requisição

Erros

HTTP	Descrição
401	Token inválido ou ausente
403	Scope ausente
422	Conta não encontrada / operação inválida

Relacionado

Dados da conta

Consulta dados cadastrais da conta autenticada

Consultar extrato

Consulta lançamentos da conta em um período