---
title: "Get total number of employees"
method: GET
path: "/employees/count"
tags: ["Employees", "Search"]
---

# Get total number of employees

`GET /employees/count`

## Query parameters

- `group` 'ACTIVE' | 'INVOLVED' | 'JOBLESS' | 'DEPARTING' | 'NEW_HIRES' | 'PAST'
- `employeeName` string — Filter employees by name
- `departmentId` string — Filter employees by department ID
- `skills` string — Filter employees by skills according to `skillsFiltering`
- `skillsFiltering` 'ANY' | 'ALL' — If more than one skill is passed, return either employees with any of the skills (`ANY`) or with all of them (`ALL`)
- `salaryFrom` string — Minimum salary amount
- `salaryTo` string — Maximum salary amount

## Response `200`

Successful operation

- integer

## Other responses

- `400` — Invalid employees search criteria
- `500` — An internal server error occurred.
- `503` — The service is temporarily unavailable. Maybe there is maintenance?

## Changes

- **2025-01-24** `4f7a5aadf782` — 1 breaking, 1 info
  - removed the enum value `NEWHIRES` from the `query` request parameter `group`
  - added the new enum value `NEW_HIRES` to the `query` request parameter `group`
- **2025-01-24** `512d594a5f71` — 1 info
  - added the new optional `query` request parameter `group`
- **2025-01-17** `4573748c6338` — 3 info
  - added the optional property `errorGUID` to the response with the `400` status
  - added the optional property `errorGUID` to the response with the `500` status
  - added the optional property `errorGUID` to the response with the `503` status
- **2025-01-13** `027398d45de5` — 1 info
  - api tag `Search` added
- **2025-01-09** `a59b7402c514` — 3 breaking
  - the response property `code` became optional for the status `400`
  - the response property `code` became optional for the status `500`
  - the response property `code` became optional for the status `503`

[Full history](https://skmtc.dev/ducin-public/apis/itcorpo-api/changes/employees/count/get.md)

---

[API](https://skmtc.dev/ducin-public/apis/itcorpo-api.md) · [All operations](https://skmtc.dev/ducin-public/apis/itcorpo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ducin-public/itcorpo-api/revisions/80675117301b/schema)