Skip to main content
GET
Get account balance
Retrieves the account balance.
  • If the currency parameter is provided, the response will be a single balance object for the currency requested.
  • If the currency parameter is omitted, the response will be an array of balance objects for all currencies with a balance greater than 0.

Need a hand with balances?

Take a read of our guide to help manage your balances, including setting up alerts.

Authorizations

X-Api-Key
string
header
required

Your API key. See the API key page on details of how to generate and store your keys.

Headers

X-Api-Version
enum<string>
default:2024-02-05

The dated version of the API, if not specified a default is used. See API versioning for more information. The dated version of the Runa API. Send it on every request: a client that omits it silently follows whatever the server default happens to be.

Available options:
2024-02-05

Query Parameters

currency
string<iso-4217>

The currency of the account, represented by ISO 4217 currency codes. Check the currencies for a listing of supported currencies.

Pattern: ^[A-Z]{3}$
Example:

"USD"

Response

OK

If the currency parameter is provided, the response will be a single balance object.

balance
string<decimal>

The balance of the account.

Pattern: ^[0-9]+(\.[0-9]{1,2})?$
Example:

"10.00"

currency
string<iso-4217>

The currency of the account, represented by ISO 4217 currency codes. Check the currencies for a listing of supported currencies.

Pattern: ^[A-Z]{3}$
Example:

"USD"