Skip to main content
Requires X-Api-Key, X-Api-Secret, and Authorization: Bearer <user-jwt> headers. See Authentication for details.
Returns all ledger accounts owned by the authenticated user, including their current balances. Use the id from the response to reference a specific account in deposit, transfer, or transaction requests.

​
Request

GET /api/v1/user/balance
No body or query parameters.

​
Response

200 OK 
{
  "items": [
    {
      "id": 619,
      "description": "Main Account",
      "asset": "USD",
      "balance": 150000,
      "type": "LIABILITY"
    }
  ],
  "meta": {
    "totalItems": 1,
    "totalPages": 1,
    "currentPage": 1,
    "itemsPerPage": 20
  }
}

​
items[]

FieldTypeDescription
idnumberAccount ID
descriptionstringAccount name
assetstringCurrency ("USD", "COP", "USDC")
balancenumberCurrent balance in smallest unit — e.g. 150000 = USD 1,500.00
typestring"LIABILITY"

​
meta

FieldTypeDescription
totalItemsnumberTotal number of accounts
totalPagesnumberTotal pages
currentPagenumberCurrent page number
itemsPerPagenumberItems per page (default 20)