Skip to main content
POST
/
balances
Create Balance
curl --request POST \
  --url http://localhost:5001/balances \
  --header 'Content-Type: application/json' \
  --header 'X-blnk-key: <api-key>' \
  --data '
{
  "ledger_id": "ldg_63d9915b-926f-49d6-93b2-4acc5ab214ed",
  "currency": "NGN"
}
'
{
  "balance_id": "bln_0be360ca-86fe-457d-be43-daa3f966d8f0",
  "balance": 0,
  "version": 0,
  "inflight_balance": 0,
  "credit_balance": 0,
  "inflight_credit_balance": 0,
  "debit_balance": 0,
  "inflight_debit_balance": 0,
  "precision": 0,
  "ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  "identity_id": "",
  "indicator": "",
  "currency": "NGN",
  "created_at": "2024-02-20T05:33:01.311600208Z",
  "inflight_expires_at": "0001-01-01T00:00:00Z",
  "meta_data": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-blnk-key
string
header
required

Body

application/json
​
ledger_id
string
required
​
currency
string
required

Response

201 - application/json; charset=utf-8

Created

​
balance_id
string
required
​
balance
integer<int32>
required
​
version
integer<int32>
required
​
inflight_balance
integer<int32>
required
​
credit_balance
integer<int32>
required
​
inflight_credit_balance
integer<int32>
required
​
debit_balance
integer<int32>
required
​
inflight_debit_balance
integer<int32>
required
​
precision
integer<int32>
required
​
ledger_id
string
required
​
identity_id
string
required
​
indicator
string
required
​
currency
string
required
​
created_at
string
required
​
inflight_expires_at
string
required
​
meta_data
string | null
required