Get headcount breakdown
Full monthly employee-distribution series for a company across both breakdown dimensions — country (employee distribution by country) and department — ordered chronologically (oldest first). Each row is one item’s percentage share of headcount for a month. Narrow to a single dimension with ?type=country|department. Powers the headcount donut and stacked-area charts on the company profile. Returns an empty list for companies with no recorded breakdown.
Authorizations
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. Revoking or deactivating a key rejects it on the next request (within a ≤5-minute server-side cache window), not at token expiry.
Headers
Pin a Stripe-style date-based API version (YYYY-MM-DD). Omit to use the latest version (2026-09-01). A pinned version is supported for 30 days after it is superseded, after which it returns 400.
"2026-09-01"
Path Parameters
Stable UUID of the entity. Numeric ids are not accepted.
1"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"
Query Parameters
Restrict to a single breakdown dimension: country (employee distribution by country) or department. Omit to return both.
country, department "country"
Response
Company monthly headcount breakdown series