---
title: "Headcount by Seniority"
description: "Break down a company's team by seniority band."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.kooperativa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Headcount by Seniority

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

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

:::note
These numbers reflect profiles **indexed in our data lake**, not the company's official headcount. They're a strong signal but not an exact count.
:::

## Query parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `company_id` | string | **Yes** | Numeric company ID |

## Code examples

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

```js title="JavaScript"
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

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

:::tip
Combine with [Hiring Signals](/companies/hiring-signals) to understand where a company is growing. If new hires are mostly ICs, they're building; mostly VPs and directors means they're scaling leadership.
:::

Source: https://docs.kooperativa.io/companies/headcount-by-seniority/index.mdx