Search for transactions using partial text matching across hashes, addresses, and workflow IDs. Returns up to 50 matching transactions. Use this when you have part of a hash or address but not the exact transaction ID.
| Type | Description |
|---|---|
all | Search across all fields (comprehensive, slower) |
hash | Blockchain transaction hash only |
address | Sender or recipient addresses |
workflowId | Temporal workflow ID only |
Searches use partial text matching (case-insensitive). A transaction matches if the search query appears anywhere in the searched field.
| Query Type | Example Query | What It Finds |
|---|---|---|
| Hash | 0x8fc | All transactions with hashes containing "0x8fc" |
| Address | 0x1234567890ab | Transactions where sender OR recipient contains this |
| Workflow ID | transaction-workflow-2024 | All workflow IDs containing "2024" |
Returns a response object { data: [...] } containing an array of matching transactions with the same structure as the list endpoint:
| 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...) |
recipientAddress | string | Recipient blockchain address (0x...) |
value | string | Transaction value in smallest unit (wei for native; token base units for ERC-20) |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Blockchain network name (e.g., Ethereum, Polygon) |
organizationId | UUID | Owning organization ID |
hash | string | Blockchain transaction hash (nullable until submitted) |
status | enum | Current lifecycle status (see Status Values below) |
failureReason | string | Failure description if status is FAILED (nullable) |
gasLimit | string | Maximum gas units allocated |
gasPrice | string | Gas price in wei (legacy transactions, nullable) |
gasUsed | string | Actual gas consumed (after confirmation) |
blockNumber | string | Block number where transaction was mined |
contractAddress | string | Deployed contract address (CONTRACT_DEPLOY only, nullable) |
metadata | object | Additional transaction metadata (see Metadata Fields) |
auditLogs | array | Complete timeline of all transaction events |
transactions:read
Search for transactions using partial text matching across hashes, addresses, and workflow IDs. Returns up to 50 matching transactions. Use this when you have part of a hash or address but not the exact transaction ID.
| Type | Description |
|---|---|
all | Search across all fields (comprehensive, slower) |
hash | Blockchain transaction hash only |
address | Sender or recipient addresses |
workflowId | Temporal workflow ID only |
Searches use partial text matching (case-insensitive). A transaction matches if the search query appears anywhere in the searched field.
| Query Type | Example Query | What It Finds |
|---|---|---|
| Hash | 0x8fc | All transactions with hashes containing "0x8fc" |
| Address | 0x1234567890ab | Transactions where sender OR recipient contains this |
| Workflow ID | transaction-workflow-2024 | All workflow IDs containing "2024" |
Returns a response object { data: [...] } containing an array of matching transactions with the same structure as the list endpoint:
| 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...) |
recipientAddress | string | Recipient blockchain address (0x...) |
value | string | Transaction value in smallest unit (wei for native; token base units for ERC-20) |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Blockchain network name (e.g., Ethereum, Polygon) |
organizationId | UUID | Owning organization ID |
hash | string | Blockchain transaction hash (nullable until submitted) |
status | enum | Current lifecycle status (see Status Values below) |
failureReason | string | Failure description if status is FAILED (nullable) |
gasLimit | string | Maximum gas units allocated |
gasPrice | string | Gas price in wei (legacy transactions, nullable) |
gasUsed | string | Actual gas consumed (after confirmation) |
blockNumber | string | Block number where transaction was mined |
contractAddress | string | Deployed contract address (CONTRACT_DEPLOY only, nullable) |
metadata | object | Additional transaction metadata (see Metadata Fields) |
auditLogs | array | Complete timeline of all transaction events |
transactions:read