# List a follow-up policy's versions

`GET https://api.parasend.com/v1/reminder_policies/{id}/versions`

Source: https://parasend.com/docs/api/follow-up-policies/versions

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).

Every version of a policy, newest first.

## Path parameters

- `id` (string, required): The policy's ID.

## Query parameters

- `limit` (integer, optional): Default: `25`.
- `cursor` (string, optional)

## Example: List a follow-up policy's versions

```bash
curl "https://api.parasend.com/v1/reminder_policies/rpol_01M6R27T5NK3830GCN9QPS9M95/versions" \
  -H "Authorization: Bearer $PARASEND_KEY"
```

```js
const res = await fetch('https://api.parasend.com/v1/reminder_policies/rpol_01M6R27T5NK3830GCN9QPS9M95/versions', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();
```

## Response 200

Paginated versions.

```json
{
  "data": [
    {
      "id": "rpv_01M6R27T60DW1D6WAYM11GBDER",
      "object": "reminder_policy_version",
      "policy_id": "rpol_01M6R27T5NK3830GCN9QPS9M95",
      "version": 2,
      "steps": [
        {
          "channel": "email",
          "after_days": 3,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "email",
          "message": {
            "preset": "firmer"
          },
          "after_days": 7,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "sms",
          "after_days": 14,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        }
      ],
      "stop_on": "confirmed",
      "created_at": "2026-11-06T09:15:05.792Z",
      "created_by": {
        "user_id": "usr_01M6R27SYD4B50414S0BZ4KBKR",
        "via": "api_key"
      }
    },
    {
      "id": "rpv_01M6R27T5NB7JTSEZ0XV7BWETG",
      "object": "reminder_policy_version",
      "policy_id": "rpol_01M6R27T5NK3830GCN9QPS9M95",
      "version": 1,
      "steps": [
        {
          "channel": "email",
          "after_days": 3,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "email",
          "message": {
            "preset": "firmer"
          },
          "after_days": 7,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "sms",
          "after_days": 10,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        }
      ],
      "stop_on": "confirmed",
      "created_at": "2026-11-06T09:15:05.781Z",
      "created_by": {
        "user_id": "usr_01M6R27SYD4B50414S0BZ4KBKR",
        "via": "api_key"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.