Skip to main content
GET
/
campaigns
Get Many Campaigns
curl --request GET \
  --url https://api.lemlist.com/api/campaigns \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "cam_KFsZWCvxY34fZjKpQ",
    "name": "Product Launch Campaign",
    "labels": [],
    "createdAt": "2025-02-20T14:45:54.230Z",
    "createdBy": "usr_PdR6Q7ZifnXYEXPJR",
    "status": "running",
    "hasError": true,
    "errors": [
      "Your campaign does not have sender."
    ]
  },
  {
    "_id": "cam_E7zXbH4n6n78TWdvX",
    "name": "Sales Outreach 2025",
    "labels": [],
    "createdAt": "2025-02-05T09:00:07.541Z",
    "createdBy": "usr_w7wBTtp3iTNbqQtGq",
    "status": "running",
    "hasError": true,
    "errors": [
      "One of your sender has no email provider.",
      "Your campaign have an invalid sender mailbox"
    ]
  },
  {
    "_id": "cam_ohtpFfMbJ5vpDkLsm",
    "name": "CRM Integration Test",
    "labels": [
      "CRM"
    ],
    "createdAt": "2023-01-27T14:58:52.482Z",
    "createdBy": "usr_ez9h9tXDLP9LqpYyp",
    "status": "running",
    "hasError": true,
    "errors": [
      "One of your sender has no email provider.",
      "Your campaign have an invalid sender mailbox"
    ]
  },
  {
    "_id": "cam_rsoutbiF7uYK8Bz2C",
    "name": "Customer Onboarding",
    "labels": [],
    "createdAt": "2022-06-14T13:32:57.880Z",
    "createdBy": "usr_ez9h9tXDLP9LqpYyp",
    "status": "running"
  }
]
This endpoint uses the Campaign object.
This endpoint retrieves the list of all campaigns.
Don’t forget to set the query parameter version to version=v2.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

​
offset
integer

Offset from the start. For pagination.

​
limit
integer

Number of campaigns to retrieve. Default: 100. Maximum: 100.

​
version
enum<string>
default:v2

Set to 'v2' to use the latest version

Available options:
v2
​
page
integer

Page number to retrieve

​
sortBy
enum<string>

The field by which to sort. Currently, only 'createdAt' is supported.

Available options:
createdAt
​
sortOrder
enum<string>

The sort direction. Use 'desc' for descending order; any other value (or omission) will sort in ascending order.

Available options:
asc,
desc
​
status
enum<string>

The campaign status. Can be: running, draft, archived, ended, paused, errors. Note: a campaign can be in multiple statuses at one time (e.g., a paused campaign with errors).

Available options:
running,
draft,
archived,
ended,
paused,
errors

Response

Success

​
_id
string

Unique campaign identifier

​
name
string

Campaign name

​
labels
string[]

Categorization labels

​
createdAt
string<date-time>

Creation timestamp

​
createdBy
string

Creator user ID

​
status
enum<string>

Campaign status

Available options:
running,
paused,
draft,
ended,
archived,
errors
​
sequenceId
string

Main sequence ID

​
scheduleIds
string[]

Associated schedule IDs

​
teamId
string

ID of the team that owns this campaign

​
hasError
boolean

Whether the campaign has errors

​
errors
string[]

List of error messages if campaign has errors

​
creator
object

Campaign creator information

​
senders
object[]

Campaign senders configuration