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

# List all benefit charges

`GET /benefits/charges`

## Query parameters

- `subscriptionId` string — Filter charges by subscription ID
- `employeeId` string — The employee whom this benefit is subscribed to
- `providerServiceCode` string — Filter charges by provider service code
- `status` 'PENDING' | 'PAID' | 'OVERDUE' | 'CANCELLED' | 'REFUNDED' — Payment status of a benefit charge
- `billingPeriodFrom` string, date — Filter charges with billing period starting from this date
- `billingPeriodTo` string, date — Filter charges with billing period ending before this date
- `page` number — Page number to retrieve
- `pageSize` number — Number of elements per page

## Response `200`

Successful operation

- BenefitCharge[]
  - `id` string, uuid, required
  - `employeeId` integer, required
  - `subscriptionId` string, required
  - `providerServiceCode` string, required
  - `billingPeriodStart` string, date, required
  - `billingPeriodEnd` string, date, required
  - `amount` number, required — Monetary value in EUR
  - `status` 'PENDING' | 'PAID' | 'OVERDUE' | 'CANCELLED' | 'REFUNDED', required — Payment status of a benefit charge

## Other responses

- `400` — Invalid benefit charges 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, 7 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - added the new optional `query` request parameter `employeeId`
  - added the new enum value `CANCELLED` to the `query` request parameter `status`
  - added the new enum value `OVERDUE` to the `query` request parameter `status`
  - …4 more

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