Get transaction status
Retrieve lightweight transaction status using any identifier format. This endpoint is optimized for frequent status polling and returns essential status information without the full audit log.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identifier | string | Yes | Transaction UUID, blockchain hash, or workflow ID |
Supported Identifier Formats
The system auto-detects the identifier format:
| Format | Example | Description |
|---|---|---|
| UUID | i8d9e0f1-a2b3-4567-cdef-890123456789 | Transaction database ID |
| Blockchain Hash | 0x8fc90a6c3ee3001cdcbbb685b4fbe67b1fa2bec5... | On-chain transaction hash (0x prefix) |
| Workflow ID | transaction-40fb11d1-62da-40c6-884a-601235d3ce62 | Internal workflow identifier |
Response Fields
| Field | Type | Description |
|---|---|---|
transactionId | UUID | Unique transaction identifier |
workflowId | string | Workflow identifier for transaction orchestration |
hash | string | Blockchain transaction hash (nullable until submitted) |
status | enum | Current lifecycle status (see Status Values below) |
senderAddress | string | Sender blockchain address |
recipientAddress | string | Recipient blockchain address |
value | string | Transaction value in human-readable format |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Network chain ID as string |
chainId | number | Blockchain network chain ID |
blockNumber | string | Block number (nullable until confirmed) |
timestamp | datetime | Blockchain confirmation timestamp (ISO 8601) |
failureReason | string | Failure description if status is FAILED (nullable) |
contractAddress | string | Deployed contract address for deployments (nullable) |
createdAt | datetime | Transaction creation timestamp (ISO 8601, UTC) |
updatedAt | datetime | Last update timestamp (ISO 8601, UTC) |
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 |
Use Cases
- Poll transaction status after submission
- Verify confirmation using blockchain hash
- Track workflow execution progress
- Build real-time status indicators
- Lightweight status checks for mobile apps
Required Permission
transactions:read
Get transaction status
Retrieve lightweight transaction status using any identifier format. This endpoint is optimized for frequent status polling and returns essential status information without the full audit log.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
identifier | string | Yes | Transaction UUID, blockchain hash, or workflow ID |
Supported Identifier Formats
The system auto-detects the identifier format:
| Format | Example | Description |
|---|---|---|
| UUID | i8d9e0f1-a2b3-4567-cdef-890123456789 | Transaction database ID |
| Blockchain Hash | 0x8fc90a6c3ee3001cdcbbb685b4fbe67b1fa2bec5... | On-chain transaction hash (0x prefix) |
| Workflow ID | transaction-40fb11d1-62da-40c6-884a-601235d3ce62 | Internal workflow identifier |
Response Fields
| Field | Type | Description |
|---|---|---|
transactionId | UUID | Unique transaction identifier |
workflowId | string | Workflow identifier for transaction orchestration |
hash | string | Blockchain transaction hash (nullable until submitted) |
status | enum | Current lifecycle status (see Status Values below) |
senderAddress | string | Sender blockchain address |
recipientAddress | string | Recipient blockchain address |
value | string | Transaction value in human-readable format |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Network chain ID as string |
chainId | number | Blockchain network chain ID |
blockNumber | string | Block number (nullable until confirmed) |
timestamp | datetime | Blockchain confirmation timestamp (ISO 8601) |
failureReason | string | Failure description if status is FAILED (nullable) |
contractAddress | string | Deployed contract address for deployments (nullable) |
createdAt | datetime | Transaction creation timestamp (ISO 8601, UTC) |
updatedAt | datetime | Last update timestamp (ISO 8601, UTC) |
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 |
Use Cases
- Poll transaction status after submission
- Verify confirmation using blockchain hash
- Track workflow execution progress
- Build real-time status indicators
- Lightweight status checks for mobile apps
Required Permission
transactions:read