Payments

List wallet policy revisions

Returns immutable revisions for the wallet control profile in newest-first order, including the currently active revision reference.

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

Request

  • Base URL
    http://localhost:8787
  • URL
    http://localhost:8787/v1/payments/wallets/{walletId}/policies/revisions
  • Auth
    HTTP bearer

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

Headers

x-project-idstring

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

Example:prj_example

Response

Wallet policy revision history

Example response

{
  "data": {
    "profile": {
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-01T00:00:00.000Z",
      "activatedAt": "2025-01-01T00:00:00.000Z",
      "archivedAt": "2025-01-01T00:00:00.000Z"
    },
    "revisions": [
      {
        "createdAt": "2025-01-01T00:00:00.000Z",
        "activatedAt": "2025-01-01T00:00:00.000Z"
      }
    ]
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes