> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# listUserPolicyParameterHistory

> Lists the saved revisions of a user's parameter values for one policy, newest first.

## Import

Call this method on a server-side ParaRestClient created with your server secret key.

```ts theme={null}
import { ParaRestClient } from "@getpara/rest-sdk";
```

async

Lists the saved revisions of a user's parameter values for one policy, newest first.

Copy method signature

### Returns

[`Promise<PermissionsV2UserParameterHistory>`](/v3/references/types/permissions#permissionsv2userparameterhistory)

Saved revisions and a cursor for older ones.

## Route

An unknown policy, or one with no saved values for the user, returns an empty `revisions` list.

```text theme={null}
GET /v1/permissions-v2/users/{userId}/user-parameters/{policyId}/history?beforeRevision=...
```

## Example

Retain `nextBeforeRevision` to read older saved values.

```ts theme={null}
const { revisions, nextBeforeRevision } = await para.listUserPolicyParameterHistory(userId, policyId);
```

## Errors

A non-success response throws `ParaRestError` with the HTTP `status`, the error `code` and a `message`. [Permissions errors](/v3/references/permissions/errors) lists every error code.

An empty path argument throws `ParaRestValidationError` before the request is sent.

| Status | Code | When |
| - | - | - |
| 400 | `INVALID_REQUEST` | `userId` is not a UUID, or `beforeRevision` is not a positive integer. |
| 403 | `FORBIDDEN` | The user has no wallet connected to your app. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.