Sign in
latestOpenAPI 3.0.32026-08-20146131.7 MB

672b1916ba61

Wallets

List wallet approval requests

Lists wallet operation approval requests for the authenticated organization or project scope.

get/v1/wallets/approval-requests

Query parameters

status'pending' | 'approved' | 'rejected' | 'canceled' | 'expired' | 'failed'

Filter by approval request status.

Example:pending

Filter by approval request status.

limitinteger

Maximum approval requests to return.

Example:50

Maximum approval requests to return.

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Wallet approval requests

Example response

{
  "data": {
    "approvalRequests": [
      {
        "id": "appr_example",
        "projectId": "prj_example",
        "status": "pending",
        "provider": "fireblocks",
        "providerReference": "fb_tx_123",
        "expiresAt": "2025-01-01T00:00:00.000Z",
        "resolvedAt": "2025-01-01T00:00:00.000Z",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-01T00:00:00.000Z",
        "wallet": {
          "walletId": "privy_wallet_123",
          "publicKey": "So11111111111111111111111111111111111111112"
        },
        "operation": {
          "walletId": "privy_wallet_123",
          "source": "api",
          "operationFamily": "payment",
          "operationType": "payment_transfer_execute",
          "status": "pending_approval",
          "executionStartedAt": "2025-01-01T00:00:00.000Z",
          "executionCompletedAt": "2025-01-01T00:00:00.000Z",
          "createdAt": "2025-01-01T00:00:00.000Z",
          "updatedAt": "2025-01-01T00:00:00.000Z"
        },
        "policyEvaluation": {
          "decision": "approval_required",
          "reasonCode": "wallet_policy_match",
          "requiresApproval": true,
          "evaluatedAt": "2025-01-01T00:00:00.000Z"
        }
      }
    ]
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}