Get balances

GET

/v1/core/accounts/{account_id}/balances

Last modified:2025-09-07 17:38:45

Maintainer:Not configured

Return balances.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://auth.nova.bb/oauth2/token

Scopes:

core:read-Read core banking resources.

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🟠429429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/v1/core/accounts//balances' \
--header 'X-Request-Id;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "current": {
        "currency": "BBD",
        "value": "50.00"
    },
    "available": {
        "currency": "BBD",
        "value": "50.00"
    },
    "holds_total": {
        "currency": "BBD",
        "value": "50.00"
    }
}

Modified at 2025-09-07 17:38:45

Get account

Create posting (double-entry)