Skip to main content
GET
Get Company
Returns the company object itself, not a list. The endpoint answers 404 COMPANY_NOT_FOUND_BY_ID when no company of your team carries this id, where GET /companies?idsOrDomains= answers 200 with an empty data array. Lookups by domain stay on GET /companies?idsOrDomains=: a domain is not guaranteed to designate a single company, so this endpoint takes ids only.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

companyId
string
required

The lemlist company ID.

Pattern: ^cpn_[a-zA-Z0-9]+$

Response

The company.

An organization record in your CRM.

_id
string

Unique company identifier

teamId
string

Team the company belongs to. Returned by GET /companies/{companyId} and the idsOrDomains and crmIds lookups; the paginated list returns it only when requested with fields.

domain
string

Website domain

linkedinUrl
string

LinkedIn company page URL. Returned by GET /companies/{companyId} and the idsOrDomains and crmIds lookups; the paginated list returns it only when requested with fields.

linkedinUrlSalesNav
string

Sales Navigator company URL. Returned by GET /companies/{companyId} and the idsOrDomains and crmIds lookups; the paginated list returns it only when requested with fields.

fields
object

Key/value attributes of the company, standard and custom (e.g., name, picture, industry, location, size, foundedOn). These values are always under fields, never at the top level of the object.

createdBy
string

User ID who created the company

ownerId
string

User ID of the owner of the company

createdAt
string<date-time>

Creation timestamp

source
string

Origin of the company record, e.g. api when it was created through this API. Returned by GET /companies/{companyId} and the idsOrDomains and crmIds lookups, not by the paginated list.

fieldRejections
object[]

Values lemlist refused to write on this company, each with its reason. Empty when none. Filter the list endpoint to only flagged companies via GET /companies?fieldRejectionReason=....

crmSync
object | null

CRM sync status for the company, resolved against the team's active CRM provider (Hubspot, Salesforce, or Pipedrive). Only present when a CRM is connected. Use this block to monitor sync state and resolve duplicates (e.g. via GET /companies?crmSyncStatus=unique_index_error_company).