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

# List Recipients

> Retrieve a paginated list of recipients for a campaign and their delivery status.

Retrieve recipients targeted by the campaign along with their individual status (e.g. `sent`, `delivered`, `opened`, `bounced`) via the Mailofly API.

### Path Parameters

**id** `string` *required*

The unique identifier of the campaign.

### Query Parameters

**limit** `number` (default: 50)

Number of recipients to return (max 100).

**offset** `number` (default: 0)

Pagination offset.

**status** `string`

Filter recipients by delivery status (`sent`, `delivered`, `opened`, `clicked`, `bounced`, `failed`).

### Response

**data** `array`

**id** `string`

The recipient delivery ID.

**email** `string`

Recipient email address.

**status** `string`

Delivery status.

**sentAt** `string`

Timestamp when email was sent.

**openedAt** `string`

Timestamp when email was first opened.

**pagination** `object`

**total** `number`

Total recipient count.

**limit** `number`

Page limit.

**offset** `number`

Page offset.

```bash cURL theme={null}
curl -X GET "https://api.mailofly.com/campaigns/cmp_123/recipients?limit=25" \
  -H "Authorization: Bearer mf_live_your_api_key"
```

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "rcp_987",
      "email": "sarah@example.com",
      "status": "delivered",
      "sentAt": "2026-09-11T12:00:00Z",
      "openedAt": "2026-09-11T12:15:30Z"
    }
  ],
  "pagination": {
    "total": 1250,
    "limit": 25,
    "offset": 0
  }
}
```


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