List transactions

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

GET

api

transactions

List transactions

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

Requires Authorization: Bearer <user-access-token> — the token from Verify login code. Pass accountId as a query parameter.

Returns paginated transactions for a specific user account. Use List accounts first to obtain the accountId.

Request

GET /api/v1/transactions?accountId=<id>
Authorization: Bearer <user-access-token>

Query parameters

Parameter	Type	Required	Description
`accountId`	number	Yes	Account ID to list transactions for
`limit`	number	No	Page size — default `20`, max `100`
`page`	number	No	Page number — default `1`
`from`	string	No	ISO 8601 date — filter start date
`to`	string	No	ISO 8601 date — filter end date

GET /api/v1/transactions?accountId=649&limit=20&page=1

Response

200 OK

[
  {
    "id": 4501,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "description": "USDC deposit",
    "status": "PENDING",
    "amount": "100.00000000",
    "debitAccountId": null,
    "creditAccountId": 649,
    "created": "2026-07-01T23:15:00.000Z"
  },
  {
    "id": 4502,
    "uuid": "550e8400-e29b-41d4-a716-446655440001",
    "description": "Transfer out",
    "status": "COMPLETED",
    "amount": "10.00000000",
    "debitAccountId": 649,
    "creditAccountId": 650,
    "created": "2026-07-01T22:00:00.000Z"
  }
]

Item fields

Field	Type	Description
`id`	number	Numeric transaction ID
`uuid`	string (UUID)	Public transaction identifier — use this with Get transaction
`description`	string	Description of the transaction
`status`	string	`"PENDING"`, `"PROCESSING"`, `"COMPLETED"`, `"FAILED"`, or `"REVERSED"`
`amount`	string	Decimal amount, in the account’s asset (returned as string for precision)
`debitAccountId`	number \| null	Account debited, if any
`creditAccountId`	number \| null	Account credited, if any
`created`	string	ISO 8601 timestamp

There is currently one asset (USDC) per account, so the transaction itself does not carry a separate currency field — infer it from the account.

Errors

HTTP status	Error	Cause
`400`	`accountId is required`	`accountId` query param missing
`401`	`Invalid or expired token`	Missing, expired, or malformed access token
`404`	`Account not found`	`accountId` does not exist or belongs to a different user

Exchange rates / TRM

Cards

Users

Login

User profile

KYC

Account Management

Financials

List transactions

Request

Query parameters

Response

Item fields

Errors

​Request

​Query parameters

​Response

​Item fields

​Errors

Request

Query parameters

Response

Item fields

Errors