List transactions
curl --request GET \
--url https://api.example.com/api/v1/transactionsconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/transactions"
response = requests.get(url)
print(response.text)Financials
List transactions
Retrieve transaction history for a user account.
GET
/
api
/
v1
/
transactions
List transactions
curl --request GET \
--url https://api.example.com/api/v1/transactionsconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/transactions"
response = requests.get(url)
print(response.text)Requires
Authorization: Bearer <user-access-token> — the token from Verify login code. Pass accountId as a query parameter.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 |