Skip to main content
GET
/
companies
Get Many Companies
curl --request GET \
  --url https://api.lemlist.com/api/companies \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "_id": "cpn_gG7PsmZFpEAnpMCHO",
      "createdAt": "2025-10-26T11:54:27.387Z",
      "createdBy": "usr_iGBmhLaxZmL0s7k1G",
      "domain": "persana.ai",
      "fields": {
        "name": "Persana AI",
        "picture": "https://example.com/logos/company-1.png"
      },
      "ownerId": "usr_iGBmhLaxZmL0s7k1G"
    },
    {
      "_id": "cpn_FEWCjzMWXo5StjpDa",
      "createdAt": "2025-10-26T11:45:18.773Z",
      "createdBy": "usr_iGBmhLaxZmL0s7k1G",
      "domain": "duno.ai",
      "fields": {
        "industry": "IT Services and IT Consulting",
        "name": "Duno.ai",
        "picture": "https://example.com/logos/company-2.png"
      },
      "ownerId": "usr_iGBmhLaxZmL0s7k1G"
    },
    {
      "_id": "cpn_2STz8x5Bexmd0nvIz",
      "createdAt": "2025-10-25T21:37:45.741Z",
      "createdBy": "usr_iGBmhLaxZmL0s7k1G",
      "domain": "tally.so",
      "fields": {
        "industry": "Computer Software",
        "name": "lemlist family",
        "picture": "https://example.com/logos/lemlist.png"
      },
      "ownerId": "usr_iGBmhLaxZmL0s7k1G"
    },
    {
      "_id": "cpn_Qf4CJuUrNUNmHm6uZ",
      "createdAt": "2025-10-24T07:26:34.956Z",
      "createdBy": "usr_ahfFktBBHUIxbVG5P",
      "domain": "example.com",
      "fields": {
        "name": "Growth & GTM Engineering"
      },
      "ownerId": "usr_ahfFktBBHUIxbVG5P"
    }
  ],
  "total": 59310
}

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.

This endpoint uses the Company object.

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

​
idsOrDomains
string

Comma-separated list of company IDs or domains to fetch. When provided, returns only matching companies (no pagination). Each value is classified as a company ID (e.g. cpn_xxx) or a domain (e.g. example.com). URLs are normalized automatically (e.g. https://example.com/path → example.com). Invalid values are silently skipped. Maximum 100 values.

​
page
integer

Page number to retrieve. Ignored when idsOrDomains is provided.

​
sortBy
enum<string>

The field by which to sort. Currently, only 'createdAt' is supported.

Available options:
createdAt
​
sortOrder
enum<string>

The sort direction. Use 'desc' for descending order; any other value (or omission) will sort in ascending order.

Available options:
asc,
desc
​
search
string

Search by company name (case insensitive)

​
fields
string

Returns selected fields. Returns all fields if empty. Each field is separated by a comma (e.g., '_id,fields.name,domain')

​
limit
integer

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

Response

Success

​
data
object[]
required
​
total
integer
required