Skip to main content
GET
/
api
/
v1
/
user
/
accounts
List accounts
curl --request GET \
  --url https://api.example.com/api/v1/user/accounts
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. Use the id from each account to reference it in deposit, transfer, and transaction endpoints.

​
Request

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

​
Response

200 OK 
{
  "items": [
    {
      "id": 619,
      "description": "Main Account",
      "asset": "MXN",
      "type": "LIABILITY",
      "number": "ACC-partner-123-abc",
      "credits": 150000,
      "debits": 0
    }
  ],
  "meta": {
    "totalItems": 1,
    "totalPages": 1,
    "currentPage": 1,
    "itemsPerPage": 20
  }
}

​
items[]

FieldTypeDescription
idnumberAccount ID — use in deposit, transfer, and transaction requests
descriptionstringAccount name set at creation
assetstringCurrency of the account ("MXN", "USD", "COP", "USDC")
typestring"LIABILITY" or "ASSET"
numberstringInternal account number assigned by the ledger
creditsnumberTotal credits in smallest unit
debitsnumberTotal debits in smallest unit
The current balance is credits - debits. Both fields are integers in the smallest unit of the currency (cents for USD/MXN, centavos for COP).