Skip to main content
GET
/
campaigns
/
reports
Get Campaign Reports
curl --request GET \
  --url https://api.lemlist.com/api/campaigns/reports \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "cam_9NsHPnykWESTncCW8",
    "name": "Product Launch Campaign",
    "creator": "usr_gmHgNGRcGPSTJrDbT|user@example.com",
    "createdAt": "2025-10-27T07:01:04.058Z",
    "createdBy": "John Smith",
    "labels": "",
    "totalCount": 0,
    "reviewedCount": 0,
    "inSequenceLeadCount": 0,
    "state": "running",
    "status": "draft",
    "senderNames": "sender@example.com",
    "sendersUsers": "Jane Doe:sender@example.com",
    "reviewed": 0,
    "emailsSent": 0,
    "emailsOpened": 0,
    "emailsClicked": 0,
    "emailsReplied": 0,
    "emailsInterested": 0,
    "linkedinSent": 0,
    "linkedinReplied": 0,
    "interested": 0,
    "notInterested": 0
  },
  {
    "_id": "cam_DqHpWfjd67n2KTj2W",
    "name": "Event Outreach Campaign",
    "creator": "usr_TPov3iJdqpjniMBDv|admin@example.co",
    "createdAt": "2022-11-09T16:41:03.538Z",
    "createdBy": "Sarah Johnson",
    "labels": "",
    "totalCount": 0,
    "reviewedCount": 32,
    "inSequenceLeadCount": 32,
    "state": "paused",
    "status": "ended",
    "senderNames": "",
    "sendersUsers": "",
    "reviewed": 0,
    "emailsSent": 20,
    "emailsOpened": 18,
    "emailsClicked": 4,
    "emailsReplied": 1,
    "emailsUnsubscribed": 1,
    "emailsInterested": 1,
    "linkedinSent": 32,
    "linkedinOpened": 15,
    "linkedinReplied": 15,
    "interested": 0,
    "notInterested": 0
  }
]
This endpoint uses the Report object.
This endpoint retrieves aggregated reports for one or multiple campaigns. It provides a convenient way to get export status and statistics across multiple campaigns in a single request.

​
Multiple campaigns

Pass multiple campaign IDs as a comma-separated list in the campaignIds parameter: 
https://api.lemlist.com/api/campaigns/reports?campaignIds=cam_123,cam_456,cam_789

​
Response structure

The response includes export status information similar to the Get Campaign Export Status endpoint, but can aggregate data across multiple campaigns.

​
Use cases

This endpoint is particularly useful for:
  • Dashboard views: Get stats for multiple campaigns at once
  • Portfolio reporting: Monitor performance across several outreach campaigns
  • Batch processing: Check export status for multiple campaigns initiated earlier
This is more efficient than calling individual campaign endpoints when you need data from multiple campaigns.

​
Example

curl --request GET \
  --url 'https://api.lemlist.com/api/campaigns/reports?campaignIds=cam_A1B2C3D4E5F6G7H8I9' \
    --header 'Authorization: Basic <encoded-value>'

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

​
campaignIds
string
required

Comma-separated list of campaign IDs to retrieve reports for

Response

Campaign reports retrieved successfully

​
_id
string

Campaign ID

​
name
string

Campaign name

​
creator
string

Creator user ID and email in format 'userId|email'

​
createdAt
string<date-time>

Campaign creation date

​
createdBy
string

Name of the user who created the campaign

​
labels
string

Campaign labels

​
totalCount
integer

Total number of leads

​
reviewedCount
integer

Number of reviewed leads

​
inSequenceLeadCount
integer

Number of leads in sequence

​
state
string

Campaign state (running, paused, etc.)

​
status
string

Campaign status (draft, ended, etc.)

​
senderNames
string

Comma-separated list of sender email addresses

​
sendersUsers
string

Comma-separated list of sender names and emails

​
reviewed
integer

Number of reviewed leads

​
emailsSent
integer

Number of emails sent

​
emailsOpened
integer

Number of emails opened

​
emailsClicked
integer

Number of emails with links clicked

​
emailsReplied
integer

Number of email replies received

​
emailsUnsubscribed
integer

Number of unsubscribes via email

​
emailsInterested
integer

Number of interested responses via email

​
linkedinSent
integer

Number of LinkedIn messages sent

​
linkedinOpened
integer

Number of LinkedIn messages opened

​
linkedinReplied
integer

Number of LinkedIn replies received

​
interested
integer

Total number of interested leads

​
notInterested
integer

Total number of not interested leads