Headcount by Seniority | Kooperativa API

GET /api/v1/company/headcount-by-seniority

Returns a breakdown of a company’s indexed employee count by seniority band.

Query parameters

Parameter	Type	Required	Description
`company_id`	string	Yes	Numeric company ID

Code examples

cURLbash

curl "https://kooperativa.io/api/v1/company/headcount-by-seniority?company_id=2135371" \
  -H "Authorization: Bearer ik_live_..."

JavaScriptjs

const res = await fetch(
  "https://kooperativa.io/api/v1/company/headcount-by-seniority?company_id=2135371",
  { headers: { Authorization: `Bearer ${process.env.KOOPERATIVA_API_KEY}` } }
);
const data = await res.json();

Response

{
  "company_id": "2135371",
  "total_indexed": 2001,
  "breakdown": {
    "c-level": 45,
    "vp": 123,
    "director": 312,
    "manager": 567,
    "individual_contributor": 954
  }
}