Get approval request
Retrieve detailed information about an approval request for a pending transaction, including the associated policy, required approvers, and current vote status.
Path Parameters
| Parameter | Type | Required | Description |
|---|
approvalRequestId | UUID | Yes | Approval request identifier |
Response Fields
| Field | Type | Description |
|---|
id | UUID | Approval request identifier |
organizationId | UUID | Organization that owns this approval request |
workflowId | string | Workflow identifier for transaction orchestration |
transactionData | object | Transaction details (see Transaction Data below) |
vaultId | UUID | Vault used for the transaction |
vaultAddress | string | Blockchain address of the vault |
requestedById | string | User ID who initiated the transaction |
status | enum | Request status (PENDING, APPROVED, REJECTED, EXPIRED) |
policyId | UUID | Policy that triggered the approval |
policyName | string | Human-readable policy name |
requiredApprovers | number | Number of approvals needed |
approverListId | UUID | Named list containing eligible approvers |
reason | string | Reason for the approval requirement |
riskFactors | string[] | List of risk factors identified |
deadline | datetime | Approval deadline (ISO 8601, nullable) |
metadata | object | Additional context (see Metadata Object below) |
createdAt | datetime | Request creation timestamp (ISO 8601, UTC) |
updatedAt | datetime | Last update timestamp (ISO 8601, UTC) |
votes | array | Array of votes cast (see Votes Array below) |
Votes Array
Each vote in the votes array includes:
| Field | Type | Description |
|---|
id | UUID | Vote record identifier |
transactionApprovalRequestId | UUID | Reference to the approval request |
approverId | string | User ID who cast the vote |
vote | string | Vote decision (APPROVED or REJECTED) |
comment | string | Optional vote comment (optional) |
createdAt | string | Vote timestamp (ISO 8601) |
Transaction Data Object
| Field | Type | Description |
|---|
from | string | Sender blockchain address |
to | string | Recipient blockchain address |
value | string | Transaction value in wei |
asset | string | Asset symbol (e.g., ETH, USDC) |
network | string | Network name |
chainId | number | Blockchain network chain ID |
type | string | Transaction type (TRANSFER, CONTRACT_CALL, etc.) |
| Field | Type | Description |
|---|
amount | string | Human-readable amount with unit |
currency | string | Currency identifier |
asset | string | Asset symbol |
recipient | string | Recipient address |
userContext | object | User information (userId, email, ipAddress) |
sessionContext | object | Session information (sessionId, device) |
Use Cases
- Display approval request details in approval UI
- Check current vote status and remaining votes needed
- Review transaction details before voting
- Track approval workflow progress
- Build approval notification systems
Required Permission
transactions:read