# List follow-up policies

`GET https://api.parasend.com/v1/reminder_policies`

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

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

Lists your follow-up policies and Parasend's own (`rpol_default`, `rpol_debt_collection`, `rpol_none`).

## Query parameters

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

## Example: List follow-up policies

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

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

## Response 200

The account's follow-up policies, Parasend's own included.

```json
{
  "data": [
    {
      "id": "rpol_01M6R27T5NK3830GCN9QPS9M95",
      "object": "reminder_policy",
      "name": "Payment reminders",
      "system": false,
      "version": 1,
      "version_id": "rpv_01M6R27T5NB7JTSEZ0XV7BWETG",
      "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",
      "customized": false,
      "is_account_default": false,
      "in_use_by_batches": 0,
      "in_use_by_deliveries": 0,
      "created_at": "2026-11-06T09:15:05.781Z",
      "updated_at": "2026-11-06T09:15:05.781Z",
      "archived_at": null
    },
    {
      "id": "rpol_none",
      "object": "reminder_policy",
      "name": "No policy",
      "system": true,
      "version": 1,
      "version_id": "rpv_none_v1",
      "steps": [],
      "stop_on": "confirmed",
      "customized": false,
      "is_account_default": false,
      "in_use_by_batches": 0,
      "in_use_by_deliveries": 0,
      "created_at": "2026-11-06T09:15:05.549Z",
      "updated_at": "2026-11-06T09:15:05.549Z",
      "archived_at": null
    },
    {
      "id": "rpol_debt_collection",
      "object": "reminder_policy",
      "name": "Debt collection",
      "system": true,
      "version": 1,
      "version_id": "rpv_debt_collection_v1",
      "steps": [
        {
          "channel": "email",
          "after_days": 2,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "sms",
          "after_days": 5,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "paper",
          "after_days": 10,
          "conditions": [
            "not_delivered"
          ],
          "requires_approval": true,
          "available": false
        }
      ],
      "stop_on": "confirmed",
      "customized": false,
      "is_account_default": false,
      "in_use_by_batches": 0,
      "in_use_by_deliveries": 0,
      "created_at": "2026-11-06T09:15:05.547Z",
      "updated_at": "2026-11-06T09:15:05.548Z",
      "archived_at": null
    },
    {
      "id": "rpol_default",
      "object": "reminder_policy",
      "name": "Default",
      "system": true,
      "version": 1,
      "version_id": "rpv_default_v1",
      "steps": [
        {
          "channel": "email",
          "after_days": 3,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        },
        {
          "channel": "email",
          "after_days": 7,
          "conditions": [
            "not_delivered"
          ],
          "available": true
        }
      ],
      "stop_on": "confirmed",
      "customized": false,
      "is_account_default": false,
      "in_use_by_batches": 0,
      "in_use_by_deliveries": 0,
      "created_at": "2026-11-06T09:15:05.537Z",
      "updated_at": "2026-11-06T09:15:05.540Z",
      "archived_at": null
    }
  ],
  "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.