List transactions - QASH API Reference

Requires X-Api-Key, X-Api-Secret, and Authorization: Bearer <user-jwt> headers. See Authentication for details.

Returns transactions for the authenticated user. Supports two query modes:

Recent mode — omit accountId, use size to get the N most recent transactions across all accounts.
Account mode — include accountId with limit and offset to paginate transactions for a specific account.

Request

GET /api/v1/user/transactions

Query parameters

Parameter	Type	Default	Description
`size`	number	`20`	Number of recent transactions to return (recent mode)
`accountId`	number	—	Filter by account ID (account mode)
`limit`	number	—	Page size — required when `accountId` is provided
`offset`	number	—	Number of records to skip — required when `accountId` is provided

# Recent mode
GET /api/v1/user/transactions?size=10

# Account mode
GET /api/v1/user/transactions?accountId=619&limit=20&offset=0

Response

200 OK

{
  "items": [
    {
      "id": 4501,
      "description": "Initial top-up",
      "status": "COMPLETED",
      "amount": 100000,
      "currency": "USD",
      "createdAt": "2026-06-05T14:00:00.000Z"
    }
  ],
  "total": 1,
  "pages": 1,
  "page": 1,
  "limit": 20
}

`items[]`

Field	Type	Description
`id`	number	Transaction ID
`description`	string	Description of the transaction
`status`	string	`"COMPLETED"`, `"PENDING"`, or `"FAILED"`
`amount`	number	Amount in smallest unit
`currency`	string	Currency of the transaction
`createdAt`	string	ISO 8601 timestamp

Pagination

Field	Type	Description
`total`	number	Total number of transactions
`pages`	number	Total pages
`page`	number	Current page
`limit`	number	Items per page

​Request

​Query parameters

​Response

​items[]

​Pagination

Request

Query parameters

Response

`items[]`

Pagination