Get transaction by ID
Retrieve complete details about a specific transaction including full transaction data, current status, blockchain confirmation details, and audit log timeline.
Path Parameters
| Parameter | Type | Required | Description |
|---|
id | UUID | Yes | Transaction UUID (obtained from list or workflow responses) |
Response Fields
| 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 human-readable format |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Network chain ID as string |
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 Gwei (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 transactions only, nullable) |
metadata | object | Additional transaction metadata (see Metadata Fields) |
auditLogs | array | Complete timeline of all transaction events |
| Field | Type | Description |
|---|
eventId | UUID | Event identifier |
confirmedAt | datetime | Confirmation timestamp (ISO 8601) |
eventSource | string | Source service that processed the event |
confirmationCount | number | Number of block confirmations |
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 |
PENDING_MEMPOOL | In blockchain mempool awaiting inclusion |
CONFIRMED | Successfully confirmed on blockchain |
FAILED | Execution failed |
REPLACED | Replaced by a transaction with higher gas price |
CANCELLED | Cancelled before execution |
DROPPED | Dropped from mempool without inclusion |
DENIED | Denied by policy evaluation |
APPROVAL_REJECTED | Rejected during approval workflow |
Use Cases
- Display full transaction details in a detail view
- Verify transaction execution and confirmation status
- View complete audit trail for compliance
- Debug failed transactions with failure reason
- Export single transaction data for records
Required Permission
transactions:read