Skip to main content
GET
/
api
/
data
/
companies
/
{id}
/
headcount-breakdown
Get headcount breakdown
curl --request GET \
  --url https://api-next.dealroom.co/api/data/companies/{id}/headcount-breakdown \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "breakdown_type": "country",
      "item_id": 233,
      "item_name": "United States",
      "year": 2025,
      "month": 6,
      "percentage": 42.5
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations.

Path Parameters

​
id
string<uuid>
required

Stable UUID of the entity. Numeric ids are not accepted.

Minimum string length: 1
Example:

"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"

Query Parameters

​
type
enum<string>

Restrict to a single breakdown dimension: country (employee distribution by country) or department. Omit to return both.

Available options:
country,
department
Example:

"country"

Response

Company monthly headcount breakdown series

​
data
object[]
required