Skip to main content
GET
/
activities
Get Many Activities
curl --request GET \
  --url https://api.lemlist.com/api/activities \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "act_PbKqTGpQqSlPcoOZ5",
    "type": "manualDone",
    "userId": "usr_Emu1g29BMtBixhMSP",
    "userName": "Guillaume Moubeche",
    "bot": false,
    "createdAt": "2025-10-28T08:07:38.375Z",
    "leadFirstName": "John",
    "leadLastName": "Doe",
    "leadEmail": "support@lemlist.com",
    "leadCompanyName": "Acme Inc",
    "leadId": "lea_fiDpiGV585wy3Oii2",
    "contactId": "ctc_xW8Ou6C03Csv8vatp",
    "campaignId": "cam_bSn8EORHQxbWPjHvu",
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "opportunityId": "opp_LyXDV8KHzctQdLFpG",
    "metaData": {
      "teamId": "tea_8QvkOiBfPdb2ZRhHi",
      "campaignId": "cam_bSn8EORHQxbWPjHvu",
      "leadId": "lea_fiDpiGV585wy3Oii2",
      "type": "manualDone"
    },
    "lead": {
      "_id": "lea_fiDpiGV585wy3Oii2",
      "isPaused": false,
      "state": "manualNotInterested",
      "personalized": false,
      "source": "api",
      "variables": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Acme Inc",
        "jobTitle": "Growth Engineer",
        "companyDomain": "example.com",
        "email": "support@lemlist.com",
        "preferredContactMethod": "email",
        "industry": "Technology",
        "Company name": "John Doe"
      },
      "contactId": "ctc_xW8Ou6C03Csv8vatp",
      "enrichment": {
        "emailStatus": "deliverable"
      }
    },
    "campaignName": "NEW TO DELETE",
    "sequenceTested": "B"
  },
  {
    "_id": "act_j0NrG6rYEPP9TMmWC",
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "companyId": "cpn_Qf4CJuUrNUNmHm6uZ",
    "type": "annotated",
    "createdAt": "2025-10-28T04:25:00.653Z",
    "note": "could help our GTM team be more productive",
    "sendUserId": "usr_ahfFktBBHUIxbVG5P",
    "userId": "usr_ahfFktBBHUIxbVG5P"
  },
  {
    "_id": "act_WeKrlIaQlBnM3LZ6G",
    "type": "manualNotInterested",
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "userName": "api",
    "isFirst": false,
    "bot": false,
    "createdAt": "2025-10-28T02:14:34.834Z",
    "name": "NEW TO DELETE",
    "leadFirstName": "John",
    "leadLastName": "Doe",
    "leadEmail": "support@lemlist.com",
    "leadCompanyName": "Acme Inc",
    "leadId": "lea_fiDpiGV585wy3Oii2",
    "contactId": "ctc_xW8Ou6C03Csv8vatp",
    "campaignId": "cam_bSn8EORHQxbWPjHvu",
    "metaData": {
      "teamId": "tea_8QvkOiBfPdb2ZRhHi",
      "campaignId": "cam_bSn8EORHQxbWPjHvu",
      "leadId": "lea_fiDpiGV585wy3Oii2",
      "type": "manualNotInterested"
    },
    "lead": {
      "_id": "lea_fiDpiGV585wy3Oii2",
      "isPaused": false,
      "state": "manualNotInterested",
      "personalized": false,
      "source": "api",
      "variables": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Acme Inc",
        "jobTitle": "Growth Engineer",
        "companyDomain": "example.com",
        "email": "support@lemlist.com",
        "preferredContactMethod": "email",
        "industry": "Technology",
        "Company name": "John Doe"
      },
      "contactId": "ctc_xW8Ou6C03Csv8vatp",
      "enrichment": {
        "emailStatus": "deliverable"
      }
    },
    "campaignName": "NEW TO DELETE",
    "sequenceTested": "B"
  },
  {
    "_id": "act_zktTG4HXXXSOQya5U",
    "type": "paused",
    "userName": "api",
    "bot": false,
    "createdAt": "2025-10-28T01:54:56.099Z",
    "name": "NEW TO DELETE",
    "leadFirstName": "John",
    "leadLastName": "Doe",
    "leadEmail": "support@lemlist.com",
    "leadCompanyName": "Acme Inc",
    "leadId": "lea_fiDpiGV585wy3Oii2",
    "contactId": "ctc_xW8Ou6C03Csv8vatp",
    "campaignId": "cam_bSn8EORHQxbWPjHvu",
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "metaData": {
      "teamId": "tea_8QvkOiBfPdb2ZRhHi",
      "campaignId": "cam_bSn8EORHQxbWPjHvu",
      "leadId": "lea_fiDpiGV585wy3Oii2",
      "type": "paused"
    },
    "lead": {
      "_id": "lea_fiDpiGV585wy3Oii2",
      "isPaused": false,
      "state": "manualNotInterested",
      "personalized": false,
      "source": "api",
      "variables": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Acme Inc",
        "jobTitle": "Growth Engineer",
        "companyDomain": "example.com",
        "email": "support@lemlist.com",
        "preferredContactMethod": "email",
        "industry": "Technology",
        "Company name": "John Doe"
      },
      "contactId": "ctc_xW8Ou6C03Csv8vatp",
      "enrichment": {
        "emailStatus": "deliverable"
      }
    },
    "campaignName": "NEW TO DELETE",
    "sequenceTested": "B"
  },
  {
    "_id": "act_x6esGLhoPa2SMHCZ7",
    "type": "emailsOpened",
    "isFirst": false,
    "stopped": false,
    "createdAt": "2025-10-27T20:20:59.696Z",
    "bot": false,
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "leadId": "lea_wj47uWhDbbN6Qq6oT",
    "campaignId": "cam_oxeGg6paG3ZVxjHkH",
    "sequenceId": "seq_ODjsLXkxXiySRw6dK",
    "sequenceStep": 1,
    "emailTemplateId": "etp_z3nAbjdHuewVEjIl5",
    "createdBy": "usr_EvXz6JqPSJJL9lHkp",
    "sendUserId": "usr_EvXz6JqPSJJL9lHkp",
    "name": "Unicorn campaign",
    "leadFirstName": "Sam",
    "leadLastName": "Taylor",
    "leadEmail": "sam@example.com",
    "leadCompanyName": "lemlist",
    "contactId": "ctc_FkeUdQHEfhqG2HMbK",
    "relatedSentAt": "2020-12-07T11:49:14.830Z",
    "metaData": {
      "teamId": "tea_8QvkOiBfPdb2ZRhHi",
      "campaignId": "cam_oxeGg6paG3ZVxjHkH",
      "leadId": "lea_wj47uWhDbbN6Qq6oT",
      "type": "emailsOpened",
      "createdBy": "usr_EvXz6JqPSJJL9lHkp",
      "taskId": "tsk_namMcIQnA6gxQIupP"
    },
    "lead": {
      "_id": "lea_wj47uWhDbbN6Qq6oT",
      "isPaused": false,
      "state": "emailsUnsubscribed",
      "personalized": false,
      "source": "manually",
      "variables": {
        "firstName": "Sam ",
        "lastName": "Taylor",
        "email": "sam@example.com",
        "companyName": "lemlist",
        "linkedinUrl": "https://www.linkedin.com/in/sam-doe"
      },
      "contactId": "ctc_FkeUdQHEfhqG2HMbK",
      "enrichment": {}
    },
    "campaignName": "Unicorn campaign",
    "sequenceTested": "A",
    "emailTemplateName": "Blank"
  },
  {
    "_id": "act_q4tnlXNdXsBeQceYW",
    "type": "emailsOpened",
    "isFirst": false,
    "stopped": false,
    "createdAt": "2025-10-27T20:17:24.119Z",
    "bot": false,
    "teamId": "tea_8QvkOiBfPdb2ZRhHi",
    "leadId": "lea_wj47uWhDbbN6Qq6oT",
    "campaignId": "cam_oxeGg6paG3ZVxjHkH",
    "sequenceId": "seq_ODjsLXkxXiySRw6dK",
    "sequenceStep": 1,
    "emailTemplateId": "etp_z3nAbjdHuewVEjIl5",
    "createdBy": "usr_EvXz6JqPSJJL9lHkp",
    "sendUserId": "usr_EvXz6JqPSJJL9lHkp",
    "name": "Unicorn campaign",
    "leadFirstName": "Sam",
    "leadLastName": "Taylor",
    "leadEmail": "sam@example.com",
    "leadCompanyName": "lemlist",
    "contactId": "ctc_FkeUdQHEfhqG2HMbK",
    "relatedSentAt": "2020-12-07T11:49:14.830Z",
    "metaData": {
      "teamId": "tea_8QvkOiBfPdb2ZRhHi",
      "campaignId": "cam_oxeGg6paG3ZVxjHkH",
      "leadId": "lea_wj47uWhDbbN6Qq6oT",
      "type": "emailsOpened",
      "createdBy": "usr_EvXz6JqPSJJL9lHkp",
      "taskId": "tsk_namMcIQnA6gxQIupP"
    },
    "lead": {
      "_id": "lea_wj47uWhDbbN6Qq6oT",
      "isPaused": false,
      "state": "emailsUnsubscribed",
      "personalized": false,
      "source": "manually",
      "variables": {
        "firstName": "Sam ",
        "lastName": "Taylor",
        "email": "sam@example.com",
        "companyName": "lemlist",
        "linkedinUrl": "https://www.linkedin.com/in/sam-doe"
      },
      "contactId": "ctc_FkeUdQHEfhqG2HMbK",
      "enrichment": {}
    },
    "campaignName": "Unicorn campaign",
    "sequenceTested": "A",
    "emailTemplateName": "Blank"
  }
]
This endpoint retrieves the history of all campaign activities and steps performed.

​
Filtering by date

Activities can be filtered on their createdAt field using either of two naming conventions:
  • minDate / maxDate (primary)
  • startDate / endDate (aliases, kept consistent with sibling endpoints such as /campaigns/{campaignId}/stats)
Both pairs accept either a Unix timestamp in seconds (e.g. 1715385600) or an ISO 8601 datetime (e.g. 2026-05-11T00:00:00Z). When both names are provided, the primary one wins: minDate takes precedence over startDate, and maxDate over endDate. maxDate must be strictly greater than minDate when both are set.

​
Response

The response can include sequenceStep and totalSequenceStep fields, which are zero-indexed (starting at 0).

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

​
version
enum<string>
required

API version. v2 is mandatory

Available options:
v2
​
type
string

Filter by activity type (e.g., paused)

​
campaignId
string

Filter by campaign ID

​
isFirst
boolean

Filter for first activity

​
offset
integer

Number of records to skip. Note: This is not traditional cursor-based pagination. To retrieve all activities, increment offset by the limit value on each request (e.g., offset=0, then offset=100, then offset=200, etc.).

​
limit
integer

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

​
leadId
string

Filter by lead ID

​
minDate
string

Filter activities by createdAt >= minDate. Accepts either a Unix timestamp in seconds (e.g. 1715385600) or an ISO 8601 datetime (e.g. 2026-05-11T00:00:00Z). minDate is the primary name; startDate is accepted as an alias and minDate takes precedence when both are provided.

​
maxDate
string

Filter activities by createdAt <= maxDate. Accepts either a Unix timestamp in seconds (e.g. 1715385600) or an ISO 8601 datetime (e.g. 2026-05-11T00:00:00Z). Must be strictly greater than minDate when both are provided. maxDate is the primary name; endDate is accepted as an alias and maxDate takes precedence when both are provided.

​
startDate
string

Alias for minDate, provided for consistency with sibling endpoints (e.g. /campaigns/{campaignId}/stats). Accepts either a Unix timestamp in seconds or an ISO 8601 datetime. Ignored when minDate is also provided.

​
endDate
string

Alias for maxDate, provided for consistency with sibling endpoints (e.g. /campaigns/{campaignId}/stats). Accepts either a Unix timestamp in seconds or an ISO 8601 datetime. Ignored when maxDate is also provided.

Response

Success

​
_id
string

Unique activity identifier

​
type
string

Activity type (emailOpened, emailClicked, emailReplied, etc.)

​
leadId
string

Associated lead ID

​
campaignId
string

Campaign ID

​
sequenceId
string

Sequence ID

​
stepId
string

Step ID

​
createdAt
string<date-time>

When the activity occurred