Get Many Tasks

Retrieves all pending tasks assigned to your team members.

GET /tasks

Get Many Tasks

cURL

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

200

{
  "results": [
    {
      "_id": "opp_LyXDV8KHzctQdLFpG",
      "type": "manual",
      "title": "Keep an eye on him",
      "priority": 1,
      "leadId": "lea_fiDpiGV585wy3Oii2",
      "campaignId": "cam_bSn8EORHQxbWPjHvu",
      "contactId": "ctc_xW8Ou6C03Csv8vatp",
      "dueDate": "2025-11-10T09:58:57.169Z",
      "userId": "usr_ahfFktBBHUIxbVG5P",
      "content": "does he have bandwidth to help us? would be grand"
    },
    {
      "_id": "opp_KNQOrrlGnLvEXDDS9",
      "type": "manual",
      "title": "API Reference Illustration",
      "priority": 2,
      "dueDate": "2025-10-31T07:58:00.000Z",
      "userId": "usr_ahfFktBBHUIxbVG5P",
      "content": ""
    }
  ],
  "page": "0"
}

This endpoint uses the Task object.

Tasks marked as done are automatically excluded from results.

Filtering

Use the filters query parameter to narrow results by:

• Lead attributes: fullName, email, phone, linkedin (supports value or regex)
• Campaign: campaignId (supports in/out arrays), campaignState (draft, running, ended, paused, errors, archived)
• Task properties: type (manual, phone, email, linkedin, etc.), assignedTo (userId)
• Date range: dueDate (supports from/to in YYYY-MM-DD format)

Examples:

by date and type

[
{"filterId": "dueDate", "from": "2025-02-11", "to": "2025-02-28"},
{"filterId": "type", "in": ["phone", "linkedinSend"]}
]

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

page · integer · default: 0

Page number for paginated results (0-indexed).

filters · string

JSON array of filter objects. Each filter has a filterId and specific parameters.

Available Filters:

• fullName: Filter by contact's full name.

  • Parameters: value (string) or regex (string)
  • Example: {"filterId":"fullName","value":"John Doe"}

• email: Filter by contact's email address.

  • Parameters: value (string) or regex (string)
  • Example: {"filterId":"email","value":"[e-mail]"}

• phone: Filter by contact's phone number.

  • Parameters: value (string) or regex (string)
  • Example: {"filterId":"phone","value":"[phone]"}

• linkedin: Filter by LinkedIn profile URL.

  • Parameters: value (string) or regex (string)
  • Example: {"filterId":"linkedin","value":"linkedin.com/in/johndoe"}

• campaignId: Filter by campaign IDs (inclusion/exclusion).

  • Parameters: in (array of strings) and/or out (array of strings)
  • Example: {"filterId":"campaignId","in":["cam_123"],"out":["cam_456"]}

• campaignState: Filter by campaign states.

  • Parameters: in (array of strings) and/or out (array of strings)
  • Allowed values: draft, running, ended, paused, errors, archived
  • Example: {"filterId":"campaignState","in":["running","paused"]}

• type: Filter by task type.

  • Parameters: in (array of strings) and/or out (array of strings)
  • Allowed values: manual, phone, linkedinInvite, linkedinSend, linkedinVoiceNote, emailsReplied, opportunityReplied, linkedinReplied, opportunityClicked, email, whatsappMessage
  • Example: {"filterId":"type","in":["phone","email"]}

• assignedTo: Filter by assigned user IDs.

  • Parameters: in (array of strings) and/or out (array of strings)
  • Example: {"filterId":"assignedTo","in":["usr_123","usr_456"]}

• dueDate: Filter by due date range.

  • Parameters: from (string, YYYY-MM-DD) and/or to (string, YYYY-MM-DD)
  • Example: {"filterId":"dueDate","from":"2025-01-01","to":"2025-12-31"}

Multiple filters can be combined in an array.

Response

200

application/json

Success

results · object[]

Show child attributes

page · string