---
title: "List wallet policy evaluations"
method: GET
path: "/v1/payments/wallets/{walletId}/policies/evaluations"
tags: ["Payments"]
---

# List wallet policy evaluations

`GET /v1/payments/wallets/{walletId}/policies/evaluations`

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

## Path parameters

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

## Query parameters

- `page` integer — Page number (default 1).
- `pageSize` integer — 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'
- `reasonCode` string

## Headers

- `x-project-id` string — 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 `200`

Wallet policy evaluation history

- object — Standard paginated response envelope.
  - `data` object[], required
    - `id` string, required — Policy evaluation ID.
    - `walletOperation` object, required
      - `id` string, required
      - `operationFamily` string, required
      - `operationType` string, required
      - `asset` string, nullable, required
      - `amount` string, nullable, required
      - `destination` string, nullable, required
      - `status` 'created' | 'evaluated' | 'pending_approval' | 'executing' | 'completed' | 'failed' | 'canceled', required
      - `createdAt` string, date-time, required — ISO 8601 timestamp.
      - `updatedAt` string, date-time, required — ISO 8601 timestamp.
    - `policyRevisions` object, required
      - `wallet` object, required
        - `evaluatedRevisionId` string, nullable, required
        - `activeRevisionId` string, nullable, required
      - `apiKey` object, required
        - `evaluatedRevisionId` string, nullable, required
        - `activeRevisionId` string, nullable, required
    - `decision` 'allow' | 'deny' | 'approval_required' | 'provider_approval_required' | 'review' | 'not_evaluated', required
    - `reasonCode` string, required
    - `reason` string, nullable, required
    - `matchedRules` object[], required
    - `evaluationContext` object, nullable, required — Redacted evaluation snapshot. Raw operation payloads and provider extensions are never returned.
      - `operation` object, required
        - `id` string, required
        - `organizationId` string, required
        - `projectId` string, nullable, required
        - `custodyWalletId` string, nullable, required
        - `walletId` string, required
        - `apiKeyId` string, nullable, required
        - `actor` object, nullable, required
        - `source` string, required
        - `operationFamily` string, required
        - `operationType` string, required
        - `asset` string, nullable, required
        - `amount` string, nullable, required
        - `destination` string, nullable, required
        - `context` object, required
        - `idempotencyKey` string, nullable, required
        - `createdAt` string, date-time, required — ISO 8601 timestamp.
      - `walletPolicy` object, required
        - `source` 'implicit_default_allow' | 'customer_profile', required
        - `profileId` string, nullable, required
        - `revisionId` string, nullable, required
        - `defaultAction` 'allow' | 'deny' | 'approval_required' | 'review', required
        - `decision` 'allow' | 'deny' | 'approval_required' | 'provider_approval_required' | 'review' | 'not_evaluated', required
        - `requiresApproval` boolean, required
      - `apiKeyPolicy` object, nullable, required
        - `source` 'implicit_default_allow' | 'customer_profile', required
        - `profileId` string, nullable, required
        - `revisionId` string, nullable, required
        - `defaultAction` 'allow' | 'deny' | 'approval_required' | 'review', required
        - `decision` 'allow' | 'deny' | 'approval_required' | 'provider_approval_required' | 'review' | 'not_evaluated', required
        - `requiresApproval` boolean, required
    - `requiresApproval` boolean, required
    - `approvalRequestId` string, nullable, required
    - `evaluatedAt` string, date-time, required — ISO 8601 timestamp.
  - `meta` object, required — Pagination metadata.
    - `total` integer, required — Total items.
    - `page` integer, required — Current page number.
    - `pageSize` integer, required — Items per page.
    - `hasMore` boolean, required — Whether more pages exist.
    - `requestId` string, required — Request identifier for tracing.

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)