# List leads (/api-reference/leads/listLeads)

## List leads

`GET https://app.alienmail.io/api/v1/campaigns/{id}/leads`

The leads of a campaign, newest first. Leads that were removed from the campaign are not listed.

Requires the `CAMPAIGN_READ` permission.

Authentication: `Authorization: Bearer <your API key>`

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | integer | yes | The campaign id: the number in the campaign URL in Alienmail, or `id` from the campaign list. An id that is not a campaign of your workspace returns 404. |
| `status` | query | "pending" \| "active" \| "stopped" \| "completed" \| "unsubscribed" \| "bounced" \| "skipped" | no | Only leads with this status. |
| `search` | query | string | no | Only leads whose email, first name, last name or company contains this text. Search for a full email address to look up one lead. |
| `limit` | query | integer | no | Items per page, 1 to 100. Default 25. A number outside that range is rounded to the nearest limit (`0` is 1, `500` is 100) and a fraction rounded down; anything that is not a number is the default. |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Anything else returns 400. |

### Responses

**200**: A page of leads.

```json
{
  "data": [
    {
      "email": "ada@example.com",
      "status": "active",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "salutation": "Ms.",
      "jobTitle": "Head of Engineering",
      "department": "Engineering",
      "seniority": "Director",
      "phone": "+44 20 7946 0958",
      "linkedinUrl": "https://www.linkedin.com/in/ada-lovelace",
      "gender": "female",
      "timezone": "Europe/London",
      "language": "en",
      "company": "Analytical Engines",
      "companyDomain": "analyticalengines.com",
      "industry": "Software",
      "companySize": "51-200",
      "revenue": "$10M-$50M",
      "linkedinCompanyUrl": "https://www.linkedin.com/company/analytical-engines",
      "city": "London",
      "state": "England",
      "country": "United Kingdom",
      "countryCode": "GB",
      "description": "Met at the Manchester meetup.",
      "custom": {
        "plan": "pro",
        "renewal_date": "2027-01-04"
      },
      "lastSentAt": "2026-11-13T09:30:00.000Z",
      "addedAt": "2026-11-13T09:30:00.000Z",
      "updatedAt": "2026-11-13T09:30:00.000Z"
    }
  ],
  "nextCursor": null
}
```

**400**: The request is invalid: `fields` names the parameters to fix.

**401**: The API key is missing, wrong or revoked, its creator left the workspace or was suspended, or the workspace is archived or deleted.

**403**: The API key's role lacks the permission this endpoint needs.

**404**: The campaign, lead or mailbox was not found in your workspace.

**429**: More than 120 requests in a minute with this key, or a workspace limit on adding and removing leads.

Errors look like `{ "error": { "code": "not_found", "message": "Campaign not found" } }`. See the Errors page.