---
title: "Workforce"
method: GET
path: "/companies/workforce"
tags: ["Company / Enrichment"]
---

# Workforce

`GET /companies/workforce`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/companies/workforce`
- Auth: API key in header `Authorization`

**Cost:** 5 credits per successful call

Returns workforce insights for a single company.
You must provide exactly one lookup parameter: `id` or `domain`.

The response includes observed employee count, an employee range bucket, and headcounts grouped by root departments.

## Query parameters

- `id` string, uuid
- `domain` string

## Response `200`

OK

- CompanyWorkforceInfo2
  - `company_id` string, uuid, required: The CompanyEnrich ID of the company.
  - `domain` string, required: The canonical domain of the company.
  - `observed_employee_count` integer: Observed number of distinct current employees in our people dataset.
  - `employee_count_range` unknown
  - `department_headcount` CompanyWorkforceDepartmentHeadcount, required: Headcount grouped by root department name.
    - `c_suite` integer, nullable: Headcount in the c-suite root department.
    - `product_management` integer, nullable: Headcount in the product management root department.
    - `engineering_technical` integer, nullable: Headcount in the engineering and technical root department.
    - `design` integer, nullable: Headcount in the design root department.
    - `education` integer, nullable: Headcount in the education root department.
    - `finance` integer, nullable: Headcount in the finance root department.
    - `human_resources` integer, nullable: Headcount in the human resources root department.
    - `information_technology` integer, nullable: Headcount in the information technology root department.
    - `legal` integer, nullable: Headcount in the legal root department.
    - `marketing` integer, nullable: Headcount in the marketing root department.
    - `medical_health` integer, nullable: Headcount in the medical and health root department.
    - `operations` integer, nullable: Headcount in the operations root department.
    - `sales` integer, nullable: Headcount in the sales root department.
    - `consulting` integer, nullable: Headcount in the consulting root department.
  - `unclassified_headcount` integer: Headcount where department could not be classified.
  - `history` CompanyWorkforceHistoryEntry[], nullable: Monthly workforce snapshots showing headcount changes over time. Only months where headcount changed are included.
    - `date` string, date, required: First day of the month for this snapshot.
    - `observed_employee_count` integer: Observed number of distinct employees in our people dataset for this month.
    - `employee_count_range` unknown
    - `department_headcount` CompanyWorkforceDepartmentHeadcount, required: Headcount grouped by root department name.
      - `c_suite` integer, nullable: Headcount in the c-suite root department.
      - `product_management` integer, nullable: Headcount in the product management root department.
      - `engineering_technical` integer, nullable: Headcount in the engineering and technical root department.
      - `design` integer, nullable: Headcount in the design root department.
      - `education` integer, nullable: Headcount in the education root department.
      - `finance` integer, nullable: Headcount in the finance root department.
      - `human_resources` integer, nullable: Headcount in the human resources root department.
      - `information_technology` integer, nullable: Headcount in the information technology root department.
      - `legal` integer, nullable: Headcount in the legal root department.
      - `marketing` integer, nullable: Headcount in the marketing root department.
      - `medical_health` integer, nullable: Headcount in the medical and health root department.
      - `operations` integer, nullable: Headcount in the operations root department.
      - `sales` integer, nullable: Headcount in the sales root department.
      - `consulting` integer, nullable: Headcount in the consulting root department.
    - `unclassified_headcount` integer: Headcount where department could not be classified.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)