Cost: 1 credit per successful page, including each earlier year of history.
Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history.
Pass nextCursor from this endpoint or a company’s workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page.
Invalid cursors and missing companies or historical pages do not consume credits.
GET
/
v2
/
companies
/
workforce
Get company workforce insights
curl --request GET \ --url https://api.companyenrich.com/v2/companies/workforce \ --header 'Authorization: <api-key>'
Pass this cursor with the company ID or domain to GET /v2/companies/workforce to fetch the preceding year for 1 credit. Omitted when no older history is available. Expires 30 minutes after the first page.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CompanyEnrich","description":"Company and people intelligence for your applications, workflows, and AI agents.","colors":{"primary":"#076CD9","light":"#3B82F6","dark":"#076CD9"},"logo":{"light":"https://mintcdn.com/enricky/uFhw8wLexOtLvJhN/logo/light.svg?fit=max\u0026auto=format\u0026n=uFhw8wLexOtLvJhN\u0026q=85\u0026s=8e714beb05cf47ed874ca525159c48c5","dark":"https://mintcdn.com/enricky/uFhw8wLexOtLvJhN/logo/dark.svg?fit=max\u0026auto=format\u0026n=uFhw8wLexOtLvJhN\u0026q=85\u0026s=3aa35e72390bc6fe4330cc5d3e3ec0e4","href":"https://companyenrich.com"},"favicon":"https://mintcdn.com/enricky/uFhw8wLexOtLvJhN/favicon.ico?fit=max\u0026auto=format\u0026n=uFhw8wLexOtLvJhN\u0026q=85\u0026s=cb356b117f113c02098fff8fbb9ae78f","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"]}},"navbar":{"links":[{"href":"mailto:support@companyenrich.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.companyenrich.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"enricky","hasAudioNarration":false,"actualSubdomain":"enricky","customDomains":["docs.companyenrich.com"],"gitSource":{"type":"github","owner":"companyenrich","repo":"companyenrich-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6af469509abf89268db669d2"},"entitlements":{},"buildId":"6af5cf196c77b2e5c483c3cb","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API V1","count":49},{"language":"default","tag":"API V2","count":36},{"language":"default","tag":"Guides","count":34},{"language":"default","tag":"Company · Enrichment","count":11},{"language":"default","tag":"Geo","count":10},{"language":"default","tag":"Company · Search","count":8},{"language":"default","tag":"People · Search","count":7},{"language":"default","tag":"People · Enrichment","count":7},{"language":"default","tag":"SDKs, CLI \u0026 AI agents","count":6},{"language":"default","tag":"Company · Lists","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/get-companies-workforce","slug":"/api-reference/v2/get-companies-workforce","pageMetadata":{"title":"Get company workforce insights","openapi":"openapi/v2.json GET /v2/companies/workforce","description":"**Cost:** 1 credit per successful page, including each earlier year of history.\n\nProvide exactly one lookup parameter: `id` or `domain`. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history.\n\nPass `nextCursor` from this endpoint or a company's `workforce` expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page.\n\nInvalid cursors and missing companies or historical pages do not consume credits.","href":"/api-reference/v2/get-companies-workforce"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cost:\"\n }), \" 1 credit per successful page, including each earlier year of history.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Provide exactly one lookup parameter: \", _jsx(_components.code, {\n children: \"id\"\n }), \" or \", _jsx(_components.code, {\n children: \"domain\"\n }), \". Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pass \", _jsx(_components.code, {\n children: \"nextCursor\"\n }), \" from this endpoint or a company’s \", _jsx(_components.code, {\n children: \"workforce\"\n }), \" expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Invalid cursors and missing companies or historical pages do not consume credits.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get company workforce insights","openapi":"openapi/v2.json GET /v2/companies/workforce","description":"**Cost:** 1 credit per successful page, including each earlier year of history.\n\nProvide exactly one lookup parameter: `id` or `domain`. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history.\n\nPass `nextCursor` from this endpoint or a company's `workforce` expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page.\n\nInvalid cursors and missing companies or historical pages do not consume credits.","href":"/api-reference/v2/get-companies-workforce"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Company / Enrichment"],"summary":"Get company workforce insights","description":"**Cost:** 1 credit per successful page, including each earlier year of history.\n\nProvide exactly one lookup parameter: `id` or `domain`. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history.\n\nPass `nextCursor` from this endpoint or a company's `workforce` expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page.\n\nInvalid cursors and missing companies or historical pages do not consume credits.","parameters":["e80f0c5c-816a-4884-b544-b98215c29258","5fd9d2e1-2bb9-425f-8e74-cc8a8c226787","b5d9225a-778a-47a8-898e-55fa3dba2ef5"],"responses":{"200":"6b08e80c-4a6e-4e5d-82a0-e43f724ab4a5","400":"05baefe5-85ff-49c3-9736-8b4b090dda4b","401":"1e25ea9d-8c49-442d-8a1c-566b699ccbdc","402":"784f4a59-4aec-4ebf-b4fb-7f4a8cbec80b","404":"2ad09e5e-fdf3-4ecc-967f-c1399d431ba1","422":"030d2b36-5bb3-4511-913e-5db3a89e30ff","429":"4700857f-812e-4abe-83ae-dcad19bb04ea"},"method":"get","type":"path","servers":["897fd4ab-a111-415e-bfb7-c0e04871dd9f"],"security":["0b4f61f2-0684-484d-a7c8-60064167aa63"],"path":"/v2/companies/workforce","baseUrlOptions":["https://api.companyenrich.com"],"title":"Get company workforce insights","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e80f0c5c-816a-4884-b544-b98215c29258":{"name":"id","in":"query","description":"The CompanyEnrich company ID. Provide exactly one of id or domain.","schema":{"type":"string","format":"uuid","description":"The CompanyEnrich company ID. Provide exactly one of id or domain.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"5fd9d2e1-2bb9-425f-8e74-cc8a8c226787":{"name":"domain","in":"query","description":"The company domain. Provide exactly one of id or domain.","schema":{"maxLength":1024,"type":"string","description":"The company domain. Provide exactly one of id or domain.","uniqueKey":"","typeLabel":"string"}},"b5d9225a-778a-47a8-898e-55fa3dba2ef5":{"name":"cursor","in":"query","description":"The nextCursor from a previous workforce response or company expansion. Omit for the latest 12 months.","schema":{"maxLength":1024,"type":"string","description":"The nextCursor from a previous workforce response or company expansion. Omit for the latest 12 months.","uniqueKey":"","typeLabel":"string"}}},"responses":{"6b08e80c-4a6e-4e5d-82a0-e43f724ab4a5":{"description":"OK","content":{"application/json":{"schema":{"required":["companyId","domain","observedEmployeeCount","departmentHeadcount","unclassifiedHeadcount","historyFrom","historyTo"],"type":"object","properties":{"companyId":{"type":"string","description":"The CompanyEnrich ID of the company","format":"uuid","isRequired":true,"uniqueKey":"companyId","typeLabel":"string\u003cuuid>"},"domain":{"type":"string","description":"The canonical company domain","isRequired":true,"uniqueKey":"domain","typeLabel":"string"},"observedEmployeeCount":{"type":"integer","description":"The observed number of distinct current employees in the people dataset","format":"int32","isRequired":true,"uniqueKey":"observedEmployeeCount","typeLabel":"integer\u003cint32>"},"departmentHeadcount":{"type":"object","properties":{"cSuite":{"oneOf":[{"type":"integer","description":"Observed c-suite headcount","format":"int32","uniqueKey":"departmentHeadcount.cSuite.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed c-suite headcount","format":"int32","uniqueKey":"departmentHeadcount.cSuite.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.cSuite","typeLabel":"integer\u003cint32> | null"},"productManagement":{"oneOf":[{"type":"integer","description":"Observed product management headcount","format":"int32","uniqueKey":"departmentHeadcount.productManagement.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed product management headcount","format":"int32","uniqueKey":"departmentHeadcount.productManagement.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.productManagement","typeLabel":"integer\u003cint32> | null"},"engineeringTechnical":{"oneOf":[{"type":"integer","description":"Observed engineering and technical headcount","format":"int32","uniqueKey":"departmentHeadcount.engineeringTechnical.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed engineering and technical headcount","format":"int32","uniqueKey":"departmentHeadcount.engineeringTechnical.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.engineeringTechnical","typeLabel":"integer\u003cint32> | null"},"design":{"oneOf":[{"type":"integer","description":"Observed design headcount","format":"int32","uniqueKey":"departmentHeadcount.design.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed design headcount","format":"int32","uniqueKey":"departmentHeadcount.design.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.design","typeLabel":"integer\u003cint32> | null"},"education":{"oneOf":[{"type":"integer","description":"Observed education headcount","format":"int32","uniqueKey":"departmentHeadcount.education.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed education headcount","format":"int32","uniqueKey":"departmentHeadcount.education.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.education","typeLabel":"integer\u003cint32> | null"},"finance":{"oneOf":[{"type":"integer","description":"Observed finance headcount","format":"int32","uniqueKey":"departmentHeadcount.finance.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed finance headcount","format":"int32","uniqueKey":"departmentHeadcount.finance.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.finance","typeLabel":"integer\u003cint32> | null"},"humanResources":{"oneOf":[{"type":"integer","description":"Observed human resources headcount","format":"int32","uniqueKey":"departmentHeadcount.humanResources.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed human resources headcount","format":"int32","uniqueKey":"departmentHeadcount.humanResources.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.humanResources","typeLabel":"integer\u003cint32> | null"},"informationTechnology":{"oneOf":[{"type":"integer","description":"Observed information technology headcount","format":"int32","uniqueKey":"departmentHeadcount.informationTechnology.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed information technology headcount","format":"int32","uniqueKey":"departmentHeadcount.informationTechnology.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.informationTechnology","typeLabel":"integer\u003cint32> | null"},"legal":{"oneOf":[{"type":"integer","description":"Observed legal headcount","format":"int32","uniqueKey":"departmentHeadcount.legal.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed legal headcount","format":"int32","uniqueKey":"departmentHeadcount.legal.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.legal","typeLabel":"integer\u003cint32> | null"},"marketing":{"oneOf":[{"type":"integer","description":"Observed marketing headcount","format":"int32","uniqueKey":"departmentHeadcount.marketing.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed marketing headcount","format":"int32","uniqueKey":"departmentHeadcount.marketing.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.marketing","typeLabel":"integer\u003cint32> | null"},"medicalHealth":{"oneOf":[{"type":"integer","description":"Observed medical and health headcount","format":"int32","uniqueKey":"departmentHeadcount.medicalHealth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed medical and health headcount","format":"int32","uniqueKey":"departmentHeadcount.medicalHealth.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.medicalHealth","typeLabel":"integer\u003cint32> | null"},"operations":{"oneOf":[{"type":"integer","description":"Observed operations headcount","format":"int32","uniqueKey":"departmentHeadcount.operations.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed operations headcount","format":"int32","uniqueKey":"departmentHeadcount.operations.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.operations","typeLabel":"integer\u003cint32> | null"},"sales":{"oneOf":[{"type":"integer","description":"Observed sales headcount","format":"int32","uniqueKey":"departmentHeadcount.sales.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed sales headcount","format":"int32","uniqueKey":"departmentHeadcount.sales.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.sales","typeLabel":"integer\u003cint32> | null"},"consulting":{"oneOf":[{"type":"integer","description":"Observed consulting headcount","format":"int32","uniqueKey":"departmentHeadcount.consulting.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed consulting headcount","format":"int32","uniqueKey":"departmentHeadcount.consulting.oneOf.1","typeLabel":"null"}],"uniqueKey":"departmentHeadcount.consulting","typeLabel":"integer\u003cint32> | null"}},"description":"Observed headcount grouped by department","isRequired":true,"uniqueKey":"departmentHeadcount","typeLabel":"object"},"unclassifiedHeadcount":{"type":"integer","description":"Observed headcount that could not be classified by department","format":"int32","isRequired":true,"uniqueKey":"unclassifiedHeadcount","typeLabel":"integer\u003cint32>"},"historyFrom":{"type":"string","description":"The inclusive first month of the returned 12-month history window","format":"date","isRequired":true,"uniqueKey":"historyFrom","typeLabel":"string\u003cdate>"},"historyTo":{"type":"string","description":"The exclusive end of the returned 12-month history window","format":"date","isRequired":true,"uniqueKey":"historyTo","typeLabel":"string\u003cdate>"},"employeeCountRange":{"oneOf":[{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range","uniqueKey":"employeeCountRange.oneOf.0","typeLabel":"any"},{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range","type":"null","uniqueKey":"employeeCountRange.oneOf.1","typeLabel":"null"}],"uniqueKey":"employeeCountRange","typeLabel":"any | null"},"history":{"oneOf":[{"type":"array","items":{"required":["date","observedEmployeeCount","departmentHeadcount","unclassifiedHeadcount"],"type":"object","properties":{"date":{"type":"string","description":"The first day of the snapshot month","format":"date","isRequired":true,"uniqueKey":"history.oneOf.0.items.[INDEX].date","typeLabel":"string\u003cdate>"},"observedEmployeeCount":{"type":"integer","description":"The observed number of distinct employees in the people dataset","format":"int32","isRequired":true,"uniqueKey":"history.oneOf.0.items.[INDEX].observedEmployeeCount","typeLabel":"integer\u003cint32>"},"departmentHeadcount":{"type":"object","properties":{"cSuite":{"oneOf":[{"type":"integer","description":"Observed c-suite headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.cSuite.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed c-suite headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.cSuite.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.cSuite","typeLabel":"integer\u003cint32> | null"},"productManagement":{"oneOf":[{"type":"integer","description":"Observed product management headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.productManagement.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed product management headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.productManagement.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.productManagement","typeLabel":"integer\u003cint32> | null"},"engineeringTechnical":{"oneOf":[{"type":"integer","description":"Observed engineering and technical headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.engineeringTechnical.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed engineering and technical headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.engineeringTechnical.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.engineeringTechnical","typeLabel":"integer\u003cint32> | null"},"design":{"oneOf":[{"type":"integer","description":"Observed design headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.design.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed design headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.design.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.design","typeLabel":"integer\u003cint32> | null"},"education":{"oneOf":[{"type":"integer","description":"Observed education headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.education.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed education headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.education.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.education","typeLabel":"integer\u003cint32> | null"},"finance":{"oneOf":[{"type":"integer","description":"Observed finance headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.finance.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed finance headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.finance.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.finance","typeLabel":"integer\u003cint32> | null"},"humanResources":{"oneOf":[{"type":"integer","description":"Observed human resources headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.humanResources.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed human resources headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.humanResources.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.humanResources","typeLabel":"integer\u003cint32> | null"},"informationTechnology":{"oneOf":[{"type":"integer","description":"Observed information technology headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.informationTechnology.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed information technology headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.informationTechnology.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.informationTechnology","typeLabel":"integer\u003cint32> | null"},"legal":{"oneOf":[{"type":"integer","description":"Observed legal headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.legal.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed legal headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.legal.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.legal","typeLabel":"integer\u003cint32> | null"},"marketing":{"oneOf":[{"type":"integer","description":"Observed marketing headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.marketing.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed marketing headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.marketing.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.marketing","typeLabel":"integer\u003cint32> | null"},"medicalHealth":{"oneOf":[{"type":"integer","description":"Observed medical and health headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.medicalHealth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed medical and health headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.medicalHealth.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.medicalHealth","typeLabel":"integer\u003cint32> | null"},"operations":{"oneOf":[{"type":"integer","description":"Observed operations headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.operations.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed operations headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.operations.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.operations","typeLabel":"integer\u003cint32> | null"},"sales":{"oneOf":[{"type":"integer","description":"Observed sales headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.sales.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed sales headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.sales.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.sales","typeLabel":"integer\u003cint32> | null"},"consulting":{"oneOf":[{"type":"integer","description":"Observed consulting headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.consulting.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Observed consulting headcount","format":"int32","uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.consulting.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount.consulting","typeLabel":"integer\u003cint32> | null"}},"description":"Observed headcount grouped by department","isRequired":true,"uniqueKey":"history.oneOf.0.items.[INDEX].departmentHeadcount","typeLabel":"object"},"unclassifiedHeadcount":{"type":"integer","description":"Observed headcount that could not be classified by department","format":"int32","isRequired":true,"uniqueKey":"history.oneOf.0.items.[INDEX].unclassifiedHeadcount","typeLabel":"integer\u003cint32>"},"employeeCountRange":{"oneOf":[{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range","uniqueKey":"history.oneOf.0.items.[INDEX].employeeCountRange.oneOf.0","typeLabel":"any"},{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range","type":"null","uniqueKey":"history.oneOf.0.items.[INDEX].employeeCountRange.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.oneOf.0.items.[INDEX].employeeCountRange","typeLabel":"any | null"}},"uniqueKey":"history.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Workforce change points within the history window, newest first. A point at the start carries forward the last known earlier headcount when available.","uniqueKey":"history.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"required":["date","observedEmployeeCount","departmentHeadcount","unclassifiedHeadcount"],"type":"object","properties":{"date":{"type":"string","description":"The first day of the snapshot month","format":"date"},"observedEmployeeCount":{"type":"integer","description":"The observed number of distinct employees in the people dataset","format":"int32"},"employeeCountRange":{"oneOf":[{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range"},{"enum":["1-10","11-50","51-200","201-500","501-1K","1K-5K","5K-10K","over-10K",null],"description":"The estimated employee count range","type":"null"}]},"departmentHeadcount":{"type":"object","properties":{"cSuite":{"oneOf":[{"type":"integer","description":"Observed c-suite headcount","format":"int32"},{"type":"null","description":"Observed c-suite headcount","format":"int32"}]},"productManagement":{"oneOf":[{"type":"integer","description":"Observed product management headcount","format":"int32"},{"type":"null","description":"Observed product management headcount","format":"int32"}]},"engineeringTechnical":{"oneOf":[{"type":"integer","description":"Observed engineering and technical headcount","format":"int32"},{"type":"null","description":"Observed engineering and technical headcount","format":"int32"}]},"design":{"oneOf":[{"type":"integer","description":"Observed design headcount","format":"int32"},{"type":"null","description":"Observed design headcount","format":"int32"}]},"education":{"oneOf":[{"type":"integer","description":"Observed education headcount","format":"int32"},{"type":"null","description":"Observed education headcount","format":"int32"}]},"finance":{"oneOf":[{"type":"integer","description":"Observed finance headcount","format":"int32"},{"type":"null","description":"Observed finance headcount","format":"int32"}]},"humanResources":{"oneOf":[{"type":"integer","description":"Observed human resources headcount","format":"int32"},{"type":"null","description":"Observed human resources headcount","format":"int32"}]},"informationTechnology":{"oneOf":[{"type":"integer","description":"Observed information technology headcount","format":"int32"},{"type":"null","description":"Observed information technology headcount","format":"int32"}]},"legal":{"oneOf":[{"type":"integer","description":"Observed legal headcount","format":"int32"},{"type":"null","description":"Observed legal headcount","format":"int32"}]},"marketing":{"oneOf":[{"type":"integer","description":"Observed marketing headcount","format":"int32"},{"type":"null","description":"Observed marketing headcount","format":"int32"}]},"medicalHealth":{"oneOf":[{"type":"integer","description":"Observed medical and health headcount","format":"int32"},{"type":"null","description":"Observed medical and health headcount","format":"int32"}]},"operations":{"oneOf":[{"type":"integer","description":"Observed operations headcount","format":"int32"},{"type":"null","description":"Observed operations headcount","format":"int32"}]},"sales":{"oneOf":[{"type":"integer","description":"Observed sales headcount","format":"int32"},{"type":"null","description":"Observed sales headcount","format":"int32"}]},"consulting":{"oneOf":[{"type":"integer","description":"Observed consulting headcount","format":"int32"},{"type":"null","description":"Observed consulting headcount","format":"int32"}]}},"description":"Observed headcount grouped by department"},"unclassifiedHeadcount":{"type":"integer","description":"Observed headcount that could not be classified by department","format":"int32"}}},"description":"Workforce change points within the history window, newest first. A point at the start carries forward the last known earlier headcount when available.","uniqueKey":"history.oneOf.1","typeLabel":"null"}],"uniqueKey":"history","typeLabel":"object[] | null"},"nextCursor":{"oneOf":[{"type":"string","description":"Pass this cursor with the company ID or domain to GET /v2/companies/workforce to fetch the preceding year for 1 credit. Omitted when no older history is available. Expires 30 minutes after the first page.","uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pass this cursor with the company ID or domain to GET /v2/companies/workforce to fetch the preceding year for 1 credit. Omitted when no older history is available. Expires 30 minutes after the first page.","uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextCursor","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"companyId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","domain":"\u003cstring>","observedEmployeeCount":123,"departmentHeadcount":{"cSuite":123,"productManagement":123,"engineeringTechnical":123,"design":123,"education":123,"finance":123,"humanResources":123,"informationTechnology":123,"legal":123,"marketing":123,"medicalHealth":123,"operations":123,"sales":123,"consulting":123},"unclassifiedHeadcount":123,"historyFrom":"2023-12-25","historyTo":"2023-12-25","employeeCountRange":"1-10","history":[{"date":"2023-12-25","observedEmployeeCount":123,"departmentHeadcount":{"cSuite":123,"productManagement":123,"engineeringTechnical":123,"design":123,"education":123,"finance":123,"humanResources":123,"informationTechnology":123,"legal":123,"marketing":123,"medicalHealth":123,"operations":123,"sales":123,"consulting":123},"unclassifiedHeadcount":123,"employeeCountRange":"1-10"}],"nextCursor":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"05baefe5-85ff-49c3-9736-8b4b090dda4b":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1e25ea9d-8c49-442d-8a1c-566b699ccbdc":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"784f4a59-4aec-4ebf-b4fb-7f4a8cbec80b":{"description":"Payment Required","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2ad09e5e-fdf3-4ecc-967f-c1399d431ba1":{"description":"Not Found","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"030d2b36-5bb3-4511-913e-5db3a89e30ff":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"4700857f-812e-4abe-83ae-dcad19bb04ea":{"description":"Too Many Requests","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"status.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"integer\u003cint32> | null"},"detail":{"oneOf":[{"type":"string","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":123,"detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0b4f61f2-0684-484d-a7c8-60064167aa63":{"Bearer":{"type":"apiKey","description":"API Token used for authentication. Example: \"Authorization: Bearer {token}\"","name":"Authorization","in":"header","x-bearer-format":"bearer","scopes":[],"schemeName":"Bearer"}}},"servers":{"897fd4ab-a111-415e-bfb7-c0e04871dd9f":{"url":"https://api.companyenrich.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"API Token used for authentication. Example: \"Authorization: Bearer {token}\"","name":"Authorization","in":"header","x-bearer-format":"bearer","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Authorization","type":"string","description":"API Token used for authentication. Example: \"Authorization: Bearer {token}\"","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"openapi/v2.json"},"subdomain":"enricky","siteName":"CompanyEnrich","title":"Get company workforce insights - CompanyEnrich","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T13:12:15.918Z","originalFileLocation":"api-reference/v2/get-companies-workforce.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Cost: 1 credit per successful page, including each earlier year of history. Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history. Pass nextCursor from this endpoint or a company\u0026#x27;s workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page. Invalid cursors and missing companies or historical pages do not consume credits.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CompanyEnrich\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get company workforce insights - CompanyEnrich\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cost: 1 credit per successful page, including each earlier year of history. Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history. Pass nextCursor from this endpoint or a company\u0026#x27;s workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page. Invalid cursors and missing companies or historical pages do not consume credits.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CompanyEnrich\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://enricky.mintlify.site/_mintlify/api/og/v2?division=Company+%C2%B7+Enrichment\u0026amp;title=Get+company+workforce+insights\u0026amp;description=**Cost%3A**+1+credit+per+successful+page%2C+including+each+earlier+year+of+history.%0A%0AProvide+exactly+one+lookup+parameter%3A+%60id%60+or+%60domain%60.+Returns+current+observe\u0026amp;theme=4b3a6da69f9bd8bbebb5003a\u0026amp;signature=22bed4e356baa4e33e19a3aca64422723d43691faf111fbfc04d485fc2dcc298\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get company workforce insights - CompanyEnrich\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cost: 1 credit per successful page, including each earlier year of history. Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history. Pass nextCursor from this endpoint or a company\u0026#x27;s workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page. Invalid cursors and missing companies or historical pages do not consume credits.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://enricky.mintlify.site/_mintlify/api/og/v2?division=Company+%C2%B7+Enrichment\u0026amp;title=Get+company+workforce+insights\u0026amp;description=**Cost%3A**+1+credit+per+successful+page%2C+including+each+earlier+year+of+history.%0A%0AProvide+exactly+one+lookup+parameter%3A+%60id%60+or+%60domain%60.+Returns+current+observe\u0026amp;theme=4b3a6da69f9bd8bbebb5003a\u0026amp;signature=22bed4e356baa4e33e19a3aca64422723d43691faf111fbfc04d485fc2dcc298\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/enricky/nV4Cv7_70M1dM0oI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CompanyEnrich\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#076CD9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/get-companies-workforce.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.companyenrich.com/#organization\",\"name\":\"CompanyEnrich\",\"url\":\"https://docs.companyenrich.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/enricky/uFhw8wLexOtLvJhN/logo/light.svg?fit=max\u0026auto=format\u0026n=uFhw8wLexOtLvJhN\u0026q=85\u0026s=8e714beb05cf47ed874ca525159c48c5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.companyenrich.com#website\",\"name\":\"CompanyEnrich\",\"url\":\"https://docs.companyenrich.com\",\"publisher\":{\"@id\":\"https://docs.companyenrich.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce#webpage\",\"url\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce\",\"name\":\"Get company workforce insights\",\"description\":\"Cost: 1 credit per successful page, including each earlier year of history. Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history. Pass nextCursor from this endpoint or a company's workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page. Invalid cursors and missing companies or historical pages do not consume credits.\",\"dateModified\":\"2026-11-11T13:12:15.918Z\",\"isPartOf\":{\"@id\":\"https://docs.companyenrich.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company · Enrichment\",\"item\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-companyid\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get company workforce insights\",\"item\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce#apireference\",\"headline\":\"Get company workforce insights\",\"name\":\"Get company workforce insights\",\"description\":\"Cost: 1 credit per successful page, including each earlier year of history. Provide exactly one lookup parameter: id or domain. Returns current observed employee count, employee range, and department headcounts, together with the latest 12 months of workforce history. Pass nextCursor from this endpoint or a company's workforce expansion with the same company to retrieve the preceding 12-month page. Cursors expire 30 minutes after the first page. Invalid cursors and missing companies or historical pages do not consume credits.\",\"url\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce\",\"mainEntityOfPage\":{\"@id\":\"https://docs.companyenrich.com/api-reference/v2/get-companies-workforce#webpage\"},\"dateModified\":\"2026-11-11T13:12:15.918Z\",\"publisher\":{\"@id\":\"https://docs.companyenrich.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.companyenrich.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CompanyEnrich\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CompanyEnrich\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v2/get-companies-workforce.md","siteName":"CompanyEnrich","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/getting-started"}]},{"tab":"API V2","groups":[{"group":"Overview","pages":[{"title":"API V2","href":"/api-reference/v2/overview"}]},{"group":"Company · Enrichment","pages":[{"title":"Get a company by ID","openapi":"openapi/v2.json GET /v2/companies/{companyId}","href":"/api-reference/v2/get-companies-companyid"},{"title":"Enrich a company by domain","openapi":"openapi/v2.json GET /v2/companies/enrich","href":"/api-reference/v2/get-companies-enrich"},{"title":"Enrich a company by properties","openapi":"openapi/v2.json POST /v2/companies/enrich","href":"/api-reference/v2/post-companies-enrich"},{"title":"Enrich companies by domain in batch","openapi":"openapi/v2.json POST /v2/companies/enrich/batch","href":"/api-reference/v2/post-companies-enrich-batch"},{"title":"Autocomplete companies","openapi":"openapi/v2.json GET /v2/companies/autocomplete","description":"Returns up to 10 companies whose domain matches the query in `items`: an exact domain match first, then domains that start with the query, then other matches, each ordered by company rank. A leading `www.` is ignored. A URL query is reduced to its host name. An empty query returns an empty list. No credits are deducted.","href":"/api-reference/v2/get-companies-autocomplete"},{"title":"Get company workforce insights","openapi":"openapi/v2.json GET /v2/companies/workforce","href":"/api-reference/v2/get-companies-workforce"}]},{"group":"Company · Bulk Enrichment","pages":[{"title":"Enrich company domains asynchronously","openapi":"openapi/v2.json POST /v2/companies/enrich/bulk","description":"Creates one API request per input domain, preserving input order and duplicates. Requires an API key. Requests use the ordinary V2 enrichment price and requested expansions; completed results become downloadable after their charges settle. Returns `402` unless the available balance covers every domain at that price; credits are not reserved. The request body must be UTF-8 JSON of at most 10 MiB.","href":"/api-reference/v2/post-companies-enrich-bulk"},{"title":"Download company enrichment results","openapi":"openapi/v2.json GET /v2/companies/enrich/bulk/{id}/results","href":"/api-reference/v2/get-companies-enrich-bulk-id-results"}]},{"group":"Company · Search Export","pages":[{"title":"Export a company search asynchronously","openapi":"openapi/v2.json POST /v2/companies/search/export","href":"/api-reference/v2/post-companies-search-export"},{"title":"Download company search export results","openapi":"openapi/v2.json GET /v2/companies/search/export/{id}/results","href":"/api-reference/v2/get-companies-search-export-id-results"}]},{"group":"People · Search Export","pages":[{"title":"Export a people search asynchronously","openapi":"openapi/v2.json POST /v2/people/search/export","href":"/api-reference/v2/post-people-search-export"},{"title":"Download people search export results","openapi":"openapi/v2.json GET /v2/people/search/export/{id}/results","href":"/api-reference/v2/get-people-search-export-id-results"}]},{"group":"Company · Search","pages":[{"title":"Search companies","openapi":"openapi/v2.json POST /v2/companies/search","href":"/api-reference/v2/post-companies-search"},{"title":"Count matching companies","openapi":"openapi/v2.json POST /v2/companies/search/count","href":"/api-reference/v2/post-companies-search-count"},{"title":"Preview matching companies","openapi":"openapi/v2.json POST /v2/companies/search/preview","href":"/api-reference/v2/post-companies-search-preview"}]},{"group":"People · Search","pages":[{"title":"Search people","openapi":"openapi/v2.json POST /v2/people/search","href":"/api-reference/v2/post-people-search"},{"title":"Count matching people","openapi":"openapi/v2.json POST /v2/people/search/count","href":"/api-reference/v2/post-people-search-count"},{"title":"Preview matching people","openapi":"openapi/v2.json POST /v2/people/search/preview","href":"/api-reference/v2/post-people-search-preview"}]},{"group":"Industries","pages":[{"title":"List industries","openapi":"openapi/v2.json GET /v2/industries","href":"/api-reference/v2/get-industries"}]},{"group":"Keywords","pages":[{"title":"Lookup keywords","openapi":"openapi/v2.json GET /v2/keywords/autocomplete","href":"/api-reference/v2/get-keywords-autocomplete"}]},{"group":"Technologies","pages":[{"title":"Lookup technologies","openapi":"openapi/v2.json GET /v2/technologies/autocomplete","href":"/api-reference/v2/get-technologies-autocomplete"}]},{"group":"Positions","pages":[{"title":"Lookup positions","openapi":"openapi/v2.json GET /v2/positions/autocomplete","href":"/api-reference/v2/get-positions-autocomplete"}]},{"group":"User","pages":[{"title":"Get current user information","openapi":"openapi/v2.json GET /v2/me","href":"/api-reference/v2/get-me"}]},{"group":"Batches","pages":[{"title":"List batches","openapi":"openapi/v2.json GET /v2/batches","href":"/api-reference/v2/get-batches"},{"title":"Get batch status","openapi":"openapi/v2.json GET /v2/batches/{id}","href":"/api-reference/v2/get-batches-id"},{"title":"Cancel remaining batch requests","openapi":"openapi/v2.json POST /v2/batches/{id}/cancel","href":"/api-reference/v2/post-batches-id-cancel"},{"title":"Download raw batch results","openapi":"openapi/v2.json GET /v2/batches/{id}/results","href":"/api-reference/v2/get-batches-id-results"}]},{"group":"People · Enrichment","pages":[{"title":"Get a person by ID","openapi":"openapi/v2.json GET /v2/people/{personId}","href":"/api-reference/v2/get-people-personid"},{"title":"Enrich a person by email","openapi":"openapi/v2.json POST /v2/people/enrich","href":"/api-reference/v2/post-people-enrich"},{"title":"Find a person's work email","openapi":"openapi/v2.json GET /v2/people/{personId}/email","href":"/api-reference/v2/get-people-personid-email"}]},{"group":"Geo","pages":[{"title":"Get regions","openapi":"openapi/v2.json GET /v2/geo/regions","href":"/api-reference/v2/get-geo-regions"},{"title":"Get country by code","openapi":"openapi/v2.json GET /v2/geo/countries/{countryCode}","href":"/api-reference/v2/get-geo-countries-countrycode"},{"title":"Search countries","openapi":"openapi/v2.json POST /v2/geo/countries","href":"/api-reference/v2/post-geo-countries"},{"title":"Search states","openapi":"openapi/v2.json POST /v2/geo/states","href":"/api-reference/v2/post-geo-states"},{"title":"Search cities","openapi":"openapi/v2.json POST /v2/geo/cities","href":"/api-reference/v2/post-geo-cities"}]}]},{"tab":"API V1","pages":[{"title":"API V1","href":"/api-reference/v1/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get company workforce insights - CompanyEnrich","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}