v3

latestOpenAPI 3.0.3UNLICENSED2026-07-2796235396.3 KB
ledger-sub-accounts

Create sub-account for a customer.

This endpoint helps to create sub-accounts for a customer. The endpoint requires the main account ID to create a sub-account under it.

post/ledger/subaccounts

Request body

accountIdstring uuid required

The main account ID under which the sub-account will be created.

referencestring required

A unique reference for the sub-account. This must be unique across all sub-accounts.

displayNamestring

An optional name for the sub-account.

Response

Sub-account created Successfully

idstring uuid required

Unique sub-account ID

accountIdstring uuid required

The main account ID to which this sub-account belongs.

displayNamestring

An optional name for the sub-account.

referencestring required

A unique reference for the sub-account.

currencystring required

Currency of the sub-account

frozenboolean required

Indicates if the sub-account is frozen (locked) or not.

createdDatestring date-time required

The date the sub-account was created.

Example response

{
  "currency": "USD",
  "accountBalance": {
    "balance": 1000,
    "availableBalance": 1000
  }
}