Skip to main content
GET
/
contacts
/
lists
Get Contact Lists
curl --request GET \
  --url https://api.lemlist.com/api/contacts/lists \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_id": "clt_abc123def456ghi78",
    "name": "Nurturing",
    "dynamic": false
  },
  {
    "_id": "clt_xyz789uvw012rst34",
    "name": "Enterprise Prospects",
    "dynamic": true
  }
]

Documentation Index

Fetch the complete documentation index at: https://developer.lemlist.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns all static and dynamic contact lists. Use the search parameter to filter lists by name. List IDs (clt_xxx) can be used with:
  • GET /contacts — filter contacts by list via the listId query parameter
  • POST /contacts/lists/{listId}/entities — add contacts to a list

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

​
search
string

Filter lists by name (case-insensitive partial match).

Response

Success

​
_id
string

Unique list ID (clt_xxx format)

​
name
string

Name of the contact list

​
dynamic
boolean

Whether the list is dynamic (auto-populated by filters) or static (manually managed)