Lemlist Developer Docs

Get Campaign

curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/campaigns/{campaignId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/campaigns/{campaignId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/campaigns/{campaignId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "_id": "cam_bSn8EORHQxbWPjHvu",
  "name": "Product Launch Campaign",
  "createdAt": "2025-10-27T07:01:04.058Z",
  "status": "draft",
  "creator": {
    "userId": "usr_ahfFktBBHUIxbVG5P",
    "userEmail": "support@lemlist.com"
  },
  "senders": [
    {
      "id": "usr_rhhX1KT0qgOGCOrgE",
      "email": "support@lemlist.com",
      "sendUserMailboxId": "usm_J7BzS86A1vRMc2AuB"
    }
  ]
}

"Bad team"

"Campaign not found"

GET

/

campaigns

/

{campaignId}

Get Campaign

curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/campaigns/{campaignId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/campaigns/{campaignId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/campaigns/{campaignId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "_id": "cam_bSn8EORHQxbWPjHvu",
  "name": "Product Launch Campaign",
  "createdAt": "2025-10-27T07:01:04.058Z",
  "status": "draft",
  "creator": {
    "userId": "usr_ahfFktBBHUIxbVG5P",
    "userEmail": "support@lemlist.com"
  },
  "senders": [
    {
      "id": "usr_rhhX1KT0qgOGCOrgE",
      "email": "support@lemlist.com",
      "sendUserMailboxId": "usm_J7BzS86A1vRMc2AuB"
    }
  ]
}

"Bad team"

"Campaign not found"

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.

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

Show child attributes

senders

object[]

Campaign senders configuration

Show child attributes