Skip to main content
GET
Get Company Lists
Returns all static and dynamic company lists, newest first. Use the search parameter to filter lists by name. List IDs (clt_xxx) can be used with:
  • GET /companies — filter companies by list via the listId query parameter
  • POST /companies/lists/{listId}/entities — add companies 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

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

Response

Success

_id
string

Unique list ID (clt_xxx format)

name
string

Name of the company list

dynamic
boolean

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

createdAt
string<date-time>

When the list was created. Lists are returned newest first.