[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-humanresources\u002Femployees\u002Fcount":3,"docs-tabs-humanresources\u002Femployees\u002Fcount":6},{"content":4,"lastmod":5},"\n## Number of employees\n\n`GET \u002Fv1\u002Fhumanresources\u002Femployees\u002Fcount`\n\nReturns the total number of employees in the Bitrix24 account's organizational structure. The endpoint is called without parameters and returns a single counter field.\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fhumanresources\u002Femployees\u002Fcount\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth application\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fhumanresources\u002Femployees\u002Fcount\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fhumanresources\u002Femployees\u002Fcount', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log(`Employees in the org structure: ${data.total}`)\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fhumanresources\u002Femployees\u002Fcount', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|---------|\n| `success` | boolean | Always `true` on success |\n| `data.total` | number | Total number of employees in the organizational structure |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"total\": 36\n  }\n}\n```\n\n## Error response example\n\n403 — the key lacks the `humanresources` scope:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'humanresources' scope\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | The key lacks the `humanresources` scope |\n| 401 | `TOKEN_MISSING` | The API key has no Bitrix24 tokens configured |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## See also\n\n- [Employees in several departments](\u002Fdocs\u002Fhumanresources\u002Femployees\u002Fmultidepartment)\n- [Employees](\u002Fdocs\u002Fhumanresources\u002Femployees)\n","2026-09-22",{},1794739560555]