Balances Explained

This page contains information about realtime balance APIs

Realtime Balance

You can read realtime account balances using the following API. This API works both Primary and Virtual accounts.

Get account balance

get

Path parameters

accountIdstringRequired

Header parameters

authorizationstringOptional

Authorization header containing your API Token

x-alg-noncestringOptional

Nonce used to generate the payload signature

x-alg-signaturestringOptional

Payload signature

datestringOptional

Date of the request un UTC/GMT

Responses

200

Returns account real-time balance positions

application/json

400

Input validation error

application/json

403

Forbidden

application/json

404

Account not found

application/json

422

Unprocessable entity

application/json

get

HTTPcURLJavaScriptPython

GET /v1/partner/accounts/{accountId}/balance HTTP/1.1
Host: api-url
Accept: */*

{
  "currency": "GBP",
  "availableBalance": 1,
  "ledgerBalance": 1,
  "pendingCredits": 1
}

Balance breakdown

All amounts including account balances returned in hundreds to preserve floating point precision and reduce errors on JSON serialize/deserialize steps.

ie. £1.92 represented as 192 Similarly. £27.01 would be shown as 2791

Real-time balance

{​
  "currency": "GBP",​
  "availableBalance": 400,​
  "ledgerBalance": 500,​
  "pendingCredits": 0​
​}

Balance

Available Balance

Description

Balance on account ledger minus pending debits.

Balance

Ledger Balance

Description

Balance on account ledger including pending debits, excluding pending credits.

Balance

Pending Credits

Description

Total pending funds on account ledger.

Currency code on balance is always the same currency as the account involved.