Skip to main content
GET
/
campaigns
/
{campaignId}
Get Campaign
curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "_id": "cam_9NsHPnykWESTncCW8",
  "name": "Product Launch Campaign",
  "createdAt": "2025-10-27T07:01:04.058Z",
  "status": "draft",
  "creator": {
    "userId": "usr_gmHgNGRcGPSTJrDbT",
    "userEmail": "support@lemlist.com"
  },
  "senders": [
    {
      "id": "usr_AzyCDxe92WNSrGkPz",
      "email": "support@lemlist.com",
      "sendUserMailboxId": "usm_JLtj28DpEdrwseTAc"
    }
  ]
}
This endpoint uses the Campaign object.
The labels field in the returned object is optional and only included if there are labels on the campaign.
This endpoint retrieves a single campaign by its ID.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
campaignId
string
required

The unique identifier of the campaign

Response

Success

An automated outreach workflow containing sequences of steps.

​
_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