DUducin-public
Benefits
Pagination
Search

List all benefits subscriptions

Changed on
get/benefits

Request

Query parameters

serviceNamestring

Filter benefits by service name

Example:MultiSport
categoriesstring

Comma-separated list of category codes to filter by. The search result will return benefits that match any of the provided categories (ANY).

Example:HEALTHCARE,SPORT_WELLNESS

Filter benefits by categories

employeeIdstring

The employee whom this benefit is subscribed to

Example:91720

Filter benefits by employee ID

feeFromstring

Minimum monthly fee amount

Example:100
feeTostring

Maximum monthly fee amount

Example:500.50
status'ALL' | 'ACTIVE' | 'CANCELLED'

Status filter for benefit subscriptions

Example:ACTIVE

Filter benefits by status

pagenumber

Page number to retrieve

Example:1

Specify the page number to retrieve

pageSizenumber

Number of elements per page

Example:1

Specify the number of items per page

Response

Successful operation

idstring required
category'HEALTHCARE' | 'SPORT_WELLNESS' | 'LUNCH_FOOD' | 'CULTURE_RECREATION' required
countrystring required
citystring required
monthlyFeenumber required

Monetary value in EUR

subscribedAtDatestring date required
cancelledAtDatestring date

Example response

[
  {
    "id": "60965cfccf2844a6",
    "beneficiary": {
      "name": "Eva Koster",
      "email": "evko@softix.nl"
    },
    "city": "Utrecht",
    "country": "Netherlands",
    "service": {
      "name": "MultiSport Active Plus",
      "provider": "Benefit Systems"
    },
    "monthlyFee": 250,
    "subscribedAtDate": "2016-01-01",
    "cancelledAtDate": "2016-05-31"
  }
]

Changes

  • 91c1a6d49e80Revision changes
    • warning

      deleted the query request parameter _page

    • warning

      deleted the query request parameter _pageSize

    • info

      added the new optional query request parameter page

    • info

      added the new optional query request parameter pageSize

  • 4573748c6338Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status