---
title: "List all benefits subscriptions"
method: GET
path: "/benefits"
tags: ["Benefits", "Pagination", "Search"]
---

# List all benefits subscriptions

`GET /benefits`

## 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
- `page` number — Page number to retrieve
- `pageSize` number — Number of elements per page

## Response `200`

Successful operation

- BenefitSubscription[]
  - `id` string, required
  - `service` object, required
    - `name` string, required
    - `provider` string, required
  - `beneficiary` object, required
    - `name` string, required
    - `email` string, email, required
  - `category` 'HEALTHCARE' | 'SPORT_WELLNESS' | 'LUNCH_FOOD' | 'CULTURE_RECREATION', required
  - `country` string, required
  - `city` string, required
  - `monthlyFee` number, required — Monetary value in EUR
  - `subscribedAtDate` string, date, required
  - `cancelledAtDate` string, date

## 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-02-03** `91c1a6d49e80` — 2 warning, 2 info
  - deleted the `query` request parameter `_page`
  - deleted the `query` request parameter `_pageSize`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageSize`
- **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-17** `3aadb0e6d939` — 1 info
  - added the new optional `query` request parameter `_pageSize`
- **2025-01-13** `027398d45de5` — 3 info
  - api tag `Pagination` added
  - api tag `Search` added
  - added the new optional `query` request parameter `_page`
- **2025-01-09** `2bb1ebc60ebd` — 1 breaking, 4 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - added the new enum value `ACTIVE` to the `query` request parameter `status`
  - added the new enum value `ALL` to the `query` request parameter `status`
  - added the new enum value `CANCELLED` to the `query` request parameter `status`
  - …1 more

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