> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/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`).

### Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the campaign.
</ParamField>

### Query Parameters

<ParamField query="limit" type="number" default="50">
  Number of recipients to return (max 100).
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset.
</ParamField>

<ParamField query="status" type="string">
  Filter recipients by delivery status (`sent`, `delivered`, `opened`, `clicked`, `bounced`, `failed`).
</ParamField>

### Response

<ResponseField name="data" type="array">
  <ResponseField name="id" type="string">The recipient delivery ID.</ResponseField>
  <ResponseField name="email" type="string">Recipient email address.</ResponseField>
  <ResponseField name="status" type="string">Delivery status.</ResponseField>
  <ResponseField name="sentAt" type="string">Timestamp when email was sent.</ResponseField>
  <ResponseField name="openedAt" type="string">Timestamp when email was first opened.</ResponseField>
</ResponseField>

<ResponseField name="pagination" type="object">
  <ResponseField name="total" type="number">Total recipient count.</ResponseField>
  <ResponseField name="limit" type="number">Page limit.</ResponseField>
  <ResponseField name="offset" type="number">Page offset.</ResponseField>
</ResponseField>

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

<ResponseExample>
  ```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
    }
  }
  ```
</ResponseExample>


## Related topics

- [List Sent Emails](/api/emails/list-emails.md)
- [Managing the Suppression List](/guides/deliverability/managing-the-suppression-list.md)
- [List Clicked Links](/api/campaigns/list-clicked-links.md)
- [Email Suppressions](/sending/email-suppressions.md)
- [AI onboarding](/getting-started/ai-onboarding.md)