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 URLhttp://localhost:8787
- URLhttp://localhost:8787/v1/payments/wallets/{walletId}/policies/revisions
- AuthHTTP 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"
}
}