Get balance

Get balance

curl --request GET \
  --url https://api.example.com/api/v1/user/balance

GET

api

user

balance

Get balance

curl --request GET \
  --url https://api.example.com/api/v1/user/balance

Requires Authorization: Bearer <user-access-token> — the token from Verify login code. See Authentication for details.

Returns all Qash accounts owned by the authenticated user, including their credit/debit totals. Use the id from the response to reference a specific account in deposit, transfer, or transaction requests.

This returns the same data as List accounts — both are backed by the same endpoint.

Request

GET /api/v1/user/balance
Authorization: Bearer <user-access-token>

No body or query parameters.

Response

200 OK

{
  "items": [
    {
      "id": 619,
      "asset": "USDC",
      "type": "LIABILITY",
      "credits": "1500.00000000",
      "debits": "0.00000000"
    }
  ],
  "meta": {
    "totalItems": 1,
    "totalPages": 1,
    "currentPage": 1,
    "itemsPerPage": 20
  }
}

`items[]`

Field	Type	Description
`id`	number	Account ID
`asset`	string	Currency — always `"USDC"` today
`type`	string	`"LIABILITY"`
`credits`	string	Total decimal amount credited to the account — not a smallest-unit integer
`debits`	string	Total decimal amount debited from the account — not a smallest-unit integer

Available balance is credits - debits. There is no separate balance field in the response.

`meta`

Field	Type	Description
`totalItems`	number	Total number of accounts
`totalPages`	number	Total pages
`currentPage`	number	Current page number
`itemsPerPage`	number	Items per page (default 20)

Exchange rates / TRM

Cards

Users

Login

User profile

KYC

Account Management

Financials

Request

Response

`items[]`

`meta`

​Request

​Response

​items[]

​meta

Request

Response

`items[]`

`meta`