Skip to main content
GET
Get company workforce insights

Authorizations

Authorization
string
header
required

API Token used for authentication. Example: "Authorization: Bearer {token}"

Query Parameters

id
string<uuid>

The CompanyEnrich company ID. Provide exactly one of id or domain.

domain
string

The company domain. Provide exactly one of id or domain.

Maximum string length: 1024
cursor
string

The nextCursor from a previous workforce response or company expansion. Omit for the latest 12 months.

Maximum string length: 1024

Response

OK

companyId
string<uuid>
required

The CompanyEnrich ID of the company

domain
string
required

The canonical company domain

observedEmployeeCount
integer<int32>
required

The observed number of distinct current employees in the people dataset

departmentHeadcount
object
required

Observed headcount grouped by department

unclassifiedHeadcount
integer<int32>
required

Observed headcount that could not be classified by department

historyFrom
string<date>
required

The inclusive first month of the returned 12-month history window

historyTo
string<date>
required

The exclusive end of the returned 12-month history window

employeeCountRange
any | null

The estimated employee count range

Available options:
1-10,
11-50,
51-200,
201-500,
501-1K,
1K-5K,
5K-10K,
over-10K,
null
history
object[] | null

Workforce change points within the history window, newest first. A point at the start carries forward the last known earlier headcount when available.

nextCursor
string | null

Pass this cursor with the company ID or domain to GET /v2/companies/workforce to fetch the preceding year for 1 credit. Omitted when no older history is available. Expires 30 minutes after the first page.