---
title: "List the contacts of a campaign"
method: GET
path: "/advanced/campaign/contacts"
tags: ["Campaign contacts"]
---

# List the contacts of a campaign

`GET /advanced/campaign/contacts`

## Request

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

Paginated contacts of a campaign with their status in the campaign. `page` is ZERO based. `perPage` below 10 is replaced by 20; maximum 10,000.

## Query parameters

- `id` string, required: MongoDB ObjectId: 24 hexadecimal characters.
- `page` integer, required
- `perPage` integer
- `event` union
  - string
  - string[]
- `query` string

## Response `200`

Success.

- object
  - `success` unknown
  - `list` CampaignContact[]
    - `_id` string: MongoDB ObjectId: 24 hexadecimal characters.
    - `email` string
    - `firstName` string
    - `lastName` string
    - `phone` string
    - `linkedinUrlProfile` string
    - `status` string: Status of the contact in this campaign (last meaningful activity event, for example `SENT`, `MAIL_REPLIED`), or `"-"` when nothing happened yet.
    - `lastContacted` string, date-time
    - `lastReplied` string, date-time
    - `integrationContactId` string
    - `sentiment` string
    - `custom` object: Custom variables (legacy inline copy).
  - `count` integer
  - `_id` string: Campaign id.

## Other responses

- `400`: Invalid request or business error (the API also uses 400 for "not found").
- `401`: Missing, malformed, unknown or disabled API key. The key must be exactly 48 characters, otherwise it is treated as a session token and rejected the same way.
- `500`: Unexpected error. IMPORTANT: this is also what you receive today when the per minute quota of your account is exceeded (the quota error is not mapped to 429 for API keys). No `Retry-After` header is sent. Wait until the next minute window before retrying.

---

[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)