---
title: "List email campaign contacts (paginated)"
method: GET
path: "/emails/campaign/contacts"
tags: ["Email campaigns (legacy)"]
deprecated: true
---

# List email campaign contacts (paginated)

`GET /emails/campaign/contacts`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/emails/campaign/contacts`
- Auth: API key in header `Authorization`

> **Deprecated.**

Returns a page of the campaign recipients. Pagination is 0-based (page=0 is the first page). perPage defaults to 20, values below 10 are forced to 20, and values above 10000 are capped at 10000. The response envelope is { success, list, count } (NOT { contacts, total }). event filters by contact status and MUST be an array (e.g. event[]=REPLIED); a bare string is rejected (contrast with the LinkedIn variant which also accepts a string). New integrations should use the multichannel /advanced campaign endpoints instead.

## Query parameters

- `id` string, required
- `page` string, required
- `perPage` string
- `event` string[]
- `query` string

## Response `200`

One page of contacts.

- object
  - `success` true, required
  - `list` LegacyContact[], required
    - `_id` string
    - `email` string, email
    - `firstName` string
    - `lastName` string
    - `phoneNumber` string
    - `custom` object: Custom variables.
    - `status` string: Latest status, e.g. SENT, OPENED, CLICKED, REPLIED, BOUNCED, UNSUBSCRIBED, BLACKLISTED. '-' when none.
    - `mailsSent` integer
    - `lastContacted` string, date-time
    - `lastOpen` string, date-time
    - `lastReplied` string, date-time
    - `interested` string: Legacy field, always "-" in campaign contact listings.
  - `count` integer, required: Total number of matching contacts.

## Other responses

- `400`: Business or validation error. 400 by default; Joi validation errors carry code INVALID_REQUEST.

---

[API](https://skmtc.dev/emelia/apis/emelia-api.md) · [All operations](https://skmtc.dev/emelia/apis/emelia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emelia/apis/emelia-api/revisions/8c0cb435f2c4?raw)