POST
/
balances

Authorization

Basic authentication header of the form — Basic <encoded-value>, where <encoded-value> is the base64-encoded string of your username:password.

Body

ledger_id
string
required

Unique id of the ledger the balance is created in.

currency
string
required

The currency/asset class of this balance. See the following: Understanding asset classes and Currencies

identity_id
string

Unique id of identity (if any) to be linked to the balance. Can be left out from the request body if there’s no identity to be linked.

meta_data
object

Additional metadata for the request body.

Response

balance
integer
required

The net amount being stored in the balance.

inflight_balance
integer
required

The net amount waiting to be moved into or out of the balance.

credit_balance
integer
required

Total amount moved into the balance

inflight_credit_balance
integer
required

Total amount waiting to be moved into the balance.

debit_balance
integer
required

Total amount moved out of the balance.

inflight_debit_balance
integer
required

Total amount waiting to be moved out of the balance.

ledger_id
string
required

Unique id of the ledger the balance is created in.

identity_id
string

Unique id of the identity (if any) linked to this balance.

balance_id
string
required

Unique id of the created balance.

currency
string
required

The currency/asset class of the balance.

created_at
string
required

Indicates the date & time of creation.

meta_data
User Object

Additional metadata of the balance.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please contact us or join our Discord community.

Get access to Blnk Cloud.

Manage your Blnk Ledger and explore advanced features (access control & collaboration, anomaly detection, secure storage & file management, etc.) in one dashboard.