List transactions
Query transactions for your organization with comprehensive filtering, pagination, and sorting capabilities.
Query Parameters
| Parameter | Type | Description |
|---|
page | number | Page number for pagination (starts at 1) |
limit | number | Items per page (1-100) |
status | string | Filter by status (see status values below) |
asset | string | Filter by asset symbol |
network | string | Filter by network name |
fromAddress | string | Filter by sender blockchain address |
toAddress | string | Filter by recipient blockchain address |
workflowId | string | Filter by workflow ID |
userId | string | Filter by initiating user ID |
organizationId | string | Filter by organization (admin only) |
startDate | string | Filter by start date (ISO 8601) |
endDate | string | Filter by end date (ISO 8601) |
sortBy | string | Sort field (createdAt, updatedAt, timestamp, or value) |
sortOrder | string | Sort order: asc or desc |
Status Values
| Status | Description |
|---|
CREATED | Transaction initiated, not yet submitted |
SUBMITTED | Sent to blockchain, awaiting confirmation |
PENDING_APPROVAL | Requires multi-party approval |
APPROVED | Approved, proceeding to execution |
CONFIRMED | Successfully confirmed on blockchain |
FAILED | Execution failed |
REPLACED | Replaced by a higher gas-price transaction |
CANCELLED | Cancelled before confirmation |
PENDING_MEMPOOL | Broadcast and waiting in the mempool |
DROPPED | Dropped from the mempool without confirmation |
DENIED | Blocked by policy evaluation |
APPROVAL_REJECTED | Approval workflow rejected the transaction |
Response Fields
The 200 response is wrapped as { "data": [ ... ], "pagination": { ... } }. The
fields below describe each transaction object inside the data array.
| Field | Type | Description |
|---|
id | UUID | Unique transaction identifier |
createdAt | datetime | Transaction creation timestamp (ISO 8601, UTC) |
updatedAt | datetime | Last update timestamp (ISO 8601, UTC) |
workflowId | string | Workflow identifier for transaction orchestration |
senderAddress | string | Sender blockchain address (0x..., nullable) |
recipientAddress | string | Recipient blockchain address (0x..., nullable) |
value | string | Transaction value in smallest unit (e.g., wei) |
asset | string | Asset symbol (e.g., ETH, USDC, nullable) |
network | string | Network name (e.g., Ethereum, Polygon, nullable) |
organizationId | UUID | Owning organization ID (nullable) |
hash | string | Blockchain transaction hash (nullable until submitted) |
status | enum | Current lifecycle status (see Status Values above) |
failureReason | string | Failure description if status is FAILED (nullable) |
gasLimit | string | Maximum gas units allocated (nullable) |
gasPrice | string | Gas price in wei (legacy transactions, nullable) |
gasUsed | string | Actual gas consumed after confirmation (nullable) |
blockNumber | string | Block number where transaction was mined (nullable) |
contractAddress | string | Deployed contract address for CONTRACT_DEPLOY transactions (nullable) |
metadata | object | Additional transaction metadata (nullable) |
auditLogs | array | Complete timeline of all transaction events |
| Field | Type | Description |
|---|
page | number | Current page number |
limit | number | Items per page |
total | number | Total number of transactions |
totalPages | number | Total number of pages |
hasNext | boolean | Whether more pages exist |
hasPrev | boolean | Whether previous pages exist |
Use Cases
- Build transaction history tables and dashboards
- Monitor transaction status across all vaults
- Generate reports by asset, network, or time period
- Track specific addresses for compliance
- Export transaction data for accounting
Required Permission
transactions:read