---
title: "Get total number of benefits"
method: GET
path: "/benefits/count"
tags: ["Benefits"]
---

# Get total number of benefits

`GET /benefits/count`

## Query parameters

- `serviceName` string — Filter benefits by service name
- `categories` string — Comma-separated list of category codes to filter by. The search result will return benefits that match any of the provided categories (`ANY`).
- `employeeId` string — The employee whom this benefit is subscribed to
- `feeFrom` string — Minimum monthly fee amount
- `feeTo` string — Maximum monthly fee amount
- `status` 'ALL' | 'ACTIVE' | 'CANCELLED' — Status filter for benefit subscriptions

## Response `200`

Successful operation

- integer

## Other responses

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

## Changes

- **2025-01-09** `2bb1ebc60ebd` — 1 breaking, 5 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - added the new optional `query` request parameter `categories`
  - added the new enum value `ACTIVE` to the `query` request parameter `status`
  - added the new enum value `ALL` to the `query` request parameter `status`
  - …2 more
- **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`
- **2025-01-09** `29074eeb2bb5` — 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
- **2025-01-08** `51b6a9908030` — 1 warning, 1 info
  - deleted the `query` request parameter `employeeIds`
  - added the new optional `query` request parameter `employeeId`
- **2025-01-08** `1a6865d8341f` — 1 info
  - for the `query` request parameter `employeeIds`, the type was generalized from `string` to no type

[Full history](https://skmtc.dev/ducin-public/apis/itcorpo-api/changes/benefits/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.dev/ducin-public/apis/itcorpo-api/revisions/2bb1ebc60ebd?raw)