--- title: "Changes to Get Employees" method: GET path: "/api/hris/v1/employees" --- # Changes to Get Employees `GET /api/hris/v1/employees` > Every recorded change to this operation, newest first. ## Timeline Changed in 8 of 23 revisions. - **2026-10-19** `161f45ea60df`: 1 info - **2026-10-06** `1f9bc0ad4bfb`: 42 info - **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info - **2026-08-24** `a606b0cf18c9`: 8 info - **2026-08-14** `6f24c7fcb3f8`: 9 breaking, 2 info - **2026-08-12** `47e17f6f9e04`: 2 info - **2026-08-08** `7da10dc93a21`: 5 info - **2026-08-01** `eb3486b88e55`: 3 info ## Changes - **2026-10-19** `161f45ea60df`: 1 info - added the new optional `query` request parameter `payroll_run_calendar_id` - **2026-10-06** `1f9bc0ad4bfb`: 42 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 - added the optional property `items/items/employment_type` to the response with the `200` status - removed the `-` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `-` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `-` enum value from the `items/items/gender` response property for the response status `200` - removed the `-` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `ACTIVE` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `ACTIVE_EXTERNAL` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `AMERICAN_INDIAN_OR_ALASKA_NATIVE` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `ASIAN_OR_INDIAN_SUBCONTINENT` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `BLACK_OR_AFRICAN_AMERICAN` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `CIVIL_PARTNERSHIP` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `COMMON_LAW` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `DECEASED` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `DIVORCED` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `DOMESTIC_PARTNERSHIP` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `FEMALE` enum value from the `items/items/gender` response property for the response status `200` - removed the `HEAD_OF_HOUSEHOLD` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `HISPANIC_OR_LATINO` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `INACTIVE` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `INACTIVE_EXTERNAL` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `IN_A_RELATIONSHIP` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `LEAVE` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `MALE` enum value from the `items/items/gender` response property for the response status `200` - removed the `MARRIED` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `NON-BINARY` enum value from the `items/items/gender` response property for the response status `200` - removed the `OTHER` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `OTHER` enum value from the `items/items/gender` response property for the response status `200` - removed the `OTHER` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `PENDING` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `PREFER_NOT_TO_DISCLOSE` enum value from the `items/items/ethnicity` response property for the response status `200` - removed the `PREFER_NOT_TO_DISCLOSE` enum value from the `items/items/gender` response property for the response status `200` - removed the `QUALIFYING_WIDOW_OR_WIDOWER_WITH_DEPENDENT_CHILD` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `RETIRED` enum value from the `items/items/employment_status` response property for the response status `200` - removed the `SEPARATED` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `SINGLE` enum value from the `items/items/marital_status` response property for the response status `200` - removed the `TWO_OR_MORE_RACES` enum value from the `items/items/ethnicity` response property for the response status `200` - …2 more - **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`: 8 info - `query` request parameter `cursor` 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` - for the `query` request parameter `cursor`, 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 - **2026-08-14** `6f24c7fcb3f8`: 9 breaking, 2 info - removed the enum value `-` from the `query` request parameter `employment_status` - removed the enum value `ACTIVE` from the `query` request parameter `employment_status` - removed the enum value `ACTIVE_EXTERNAL` from the `query` request parameter `employment_status` - removed the enum value `DECEASED` from the `query` request parameter `employment_status` - removed the enum value `INACTIVE` from the `query` request parameter `employment_status` - removed the enum value `INACTIVE_EXTERNAL` from the `query` request parameter `employment_status` - removed the enum value `LEAVE` from the `query` request parameter `employment_status` - removed the enum value `PENDING` from the `query` request parameter `employment_status` - removed the enum value `RETIRED` from the `query` request parameter `employment_status` - `query` request parameter `employment_status` list-of-types was widened by adding types `null` - for the `query` request parameter `employment_status`, the type was generalized from `string` to no type - **2026-08-12** `47e17f6f9e04`: 2 info - added the new optional `query` request parameter `work_locations` - added the optional property `items/items/work_locations` to the response with the `200` status - **2026-08-08** `7da10dc93a21`: 5 info - added the new optional `query` request parameter `first_name` - added the new optional `query` request parameter `last_name` - added the new optional `query` request parameter `work_email` - `query` request parameter `employee_number` list-of-types was widened by adding types `null` - for the `query` request parameter `employee_number`, 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/employees/get.md) - [API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) - [Page](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/hris/v1/employees/get)