Sign in
latestOpenAPI 3.0.32026-08-20146131.7 MB

672b1916ba61

Payments

List wallet policy evaluations

Returns paginated, filterable policy audit history for one wallet. Evaluation context is redacted and excludes raw provider payloads.

get/v1/payments/wallets/{walletId}/policies/evaluations

Path parameters

walletIdstring required

Provider wallet ID — the walletId field returned by GET /v1/wallets. The wallet record id and the public key are not accepted.

Example:privy_wallet_123

Provider wallet ID — the walletId field returned by GET /v1/wallets. The wallet record id and the public key are not accepted.

Query parameters

pageinteger

Page number (default 1).

Example:1

Page number (default 1).

pageSizeinteger

Items per page (default 25, maximum 100).

Example:50

Items per page (default 25, maximum 100).

decision'allow' | 'deny' | 'approval_required' | 'provider_approval_required' | 'review' | 'not_evaluated'
status'created' | 'evaluated' | 'pending_approval' | 'executing' | 'completed' | 'failed' | 'canceled'
operationFamily'transfer' | 'payment' | 'ramp' | 'issuance' | 'program'
reasonCodestring

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 policy evaluation history

Example response

{
  "data": [
    {
      "walletOperation": {
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-01T00:00:00.000Z"
      },
      "evaluationContext": {
        "operation": {
          "createdAt": "2025-01-01T00:00:00.000Z"
        }
      },
      "evaluatedAt": "2025-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "requestId": "req_example"
  }
}