---
title: "List all benefit charges for a specific subscription"
method: GET
path: "/benefits/{benefitId}/charges"
tags: ["Benefits", "Pagination"]
---

# List all benefit charges for a specific subscription

`GET /benefits/{benefitId}/charges`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/benefits/{benefitId}/charges`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ducin-public/apis/itcorpo-api/docs/benefits/:benefitId/charges/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `benefitId` string, required

## Query parameters

- `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
- `404`: Benefit subscription not found
- `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`: 4 info
  - added the optional property `errorGUID` to the response with the `400` status
  - added the optional property `errorGUID` to the response with the `404` 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`: 2 info
  - api tag `Pagination` added
  - added the new optional `query` request parameter `_page`
- **2025-01-09** `2bb1ebc60ebd`: 1 breaking, 6 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - added the new enum value `CANCELLED` to the `query` request parameter `status`
  - added the new enum value `OVERDUE` to the `query` request parameter `status`
  - added the new enum value `PAID` to the `query` request parameter `status`
  - …3 more

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