---
title: "Changes to Get Benefits"
method: GET
path: "/api/hris/v1/benefits"
---

# Changes to Get Benefits

`GET /api/hris/v1/benefits`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 23 revisions.

- **2026-10-06** `1f9bc0ad4bfb`: 37 info
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
- **2026-08-24** `a606b0cf18c9`: 22 info
- **2026-08-01** `eb3486b88e55`: 3 info

## Changes

- **2026-10-06** `1f9bc0ad4bfb`: 37 info
  - the endpoint scheme security `HTTPBearer AND ConnectorToken` was added to the API
  - the endpoint scheme security `ConnectorToken` was removed from the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
  - removed the `-` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `ANNUALLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `BIWEEKLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `DENTAL` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `DISABILITY` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `EMPLOYEE_1_DEPENDENT` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_1_HOUSEHOLD_MEMBER` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_CHILD` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_CHILDREN` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_DOMESTIC_PARTNER` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_FAMILY` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_ONLY` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `EMPLOYEE_SPOUSE` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `FLEXIBLE_SPENDING` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `FOURWEEKLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `HEALTH_SAVINGS` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `HOURLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `HSA_FAMILY` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `LIFE_INSURANCE` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `MEDICAL` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `MONTHLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `OTHER` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `PRO_RATA` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `QUARTERLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `RETIREMENT` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `SEMIANNUALLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `SEMIMONTHLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `SPOUSE` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `SUPPLEMENTAL_INSURANCE` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `THIRTEEN-MONTHLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `VISION` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
  - removed the `WAIVED` enum value from the `items/items/coverage_tier` response property for the response status `200`
  - removed the `WEEKLY` enum value from the `items/items/frequency` response property for the response status `200`
  - removed the `WELLNESS` enum value from the `items/items/benefit_plan_category` response property for the response status `200`
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
  - deleted the `header` request parameter `x-connector-token`
  - the endpoint scheme security `ConnectorToken` was added to the API
- **2026-08-24** `a606b0cf18c9`: 22 info
  - `query` request parameter `benefit_plan_category` list-of-types was widened by adding types `null`
  - `query` request parameter `cursor` list-of-types was widened by adding types `null`
  - `query` request parameter `effective_date_from` list-of-types was widened by adding types `null`
  - `query` request parameter `effective_date_to` list-of-types was widened by adding types `null`
  - `query` request parameter `end_date_from` list-of-types was widened by adding types `null`
  - `query` request parameter `end_date_to` list-of-types was widened by adding types `null`
  - `query` request parameter `expand` list-of-types was widened by adding types `null`
  - `query` request parameter `modified_after` list-of-types was widened by adding types `null`
  - `query` request parameter `remote_id` list-of-types was widened by adding types `null`
  - `query` request parameter `start_date_from` list-of-types was widened by adding types `null`
  - `query` request parameter `start_date_to` list-of-types was widened by adding types `null`
  - for the `query` request parameter `benefit_plan_category`, the type was generalized from `string` to no type
  - for the `query` request parameter `cursor`, the type was generalized from `string` to no type
  - for the `query` request parameter `effective_date_from`, the type was generalized from `string` to no type
  - for the `query` request parameter `effective_date_to`, the type was generalized from `string` to no type
  - for the `query` request parameter `end_date_from`, the type was generalized from `string` to no type
  - for the `query` request parameter `end_date_to`, the type was generalized from `string` to no type
  - for the `query` request parameter `expand`, the type was generalized from `string` to no type
  - for the `query` request parameter `modified_after`, the type was generalized from `string` to no type
  - for the `query` request parameter `remote_id`, the type was generalized from `string` to no type
  - for the `query` request parameter `start_date_from`, the type was generalized from `string` to no type
  - for the `query` request parameter `start_date_to`, the type was generalized from `string` to no type
- **2026-08-01** `eb3486b88e55`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

---

[Operation](https://skmtc.dev/bindbee/apis/bindbee-apis/docs/api/hris/v1/benefits/get.md) - [API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) - [Page](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/hris/v1/benefits/get)
