GET/api/v2/contas/saldo
Consultar saldo
Consulta o saldo da conta autenticada. Scope: contas.saldo.read.
Parâmetros
AcceptObrigatório
headerTipo:
stringAutenticação e scopes
Requer Bearer token. Scope: contas.saldo.read.
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
Sem query params.
Retorno 200
| 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 | Última alteração (Y-m-d H:i:s) |
correlationId | string | Correlação |
Códigos
| Código | Descrição |
|---|---|
| 200 | OK |
| 401 | Token inválido |
| 403 | Scope ausente |
| 422 | Conta não encontrada / operação inválida |
Notas
- Técnica: Consultar saldo.
curl --location 'https://api-h.nuvende.com.br/api/v2/contas/saldo' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{ access_token }}'
{
"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"
}