---
title: "Changes to Get Employee By Id"
method: GET
path: "/api/hris/v1/employees/{id}"
---

# Changes to Get Employee By Id

`GET /api/hris/v1/employees/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 23 revisions.

- **2026-10-06** `1f9bc0ad4bfb`: 42 info
- **2026-09-27** `cf8209fb1cd7`: 1 warning, 1 info
- **2026-08-24** `a606b0cf18c9`: 2 info
- **2026-08-12** `47e17f6f9e04`: 1 info
- **2026-08-01** `eb3486b88e55`: 4 info

## Changes

- **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 `employment_type` to the response with the `200` status
  - removed the `-` enum value from the `employment_status` response property for the response status `200`
  - removed the `-` enum value from the `ethnicity` response property for the response status `200`
  - removed the `-` enum value from the `gender` response property for the response status `200`
  - removed the `-` enum value from the `marital_status` response property for the response status `200`
  - removed the `ACTIVE` enum value from the `employment_status` response property for the response status `200`
  - removed the `ACTIVE_EXTERNAL` enum value from the `employment_status` response property for the response status `200`
  - removed the `AMERICAN_INDIAN_OR_ALASKA_NATIVE` enum value from the `ethnicity` response property for the response status `200`
  - removed the `ASIAN_OR_INDIAN_SUBCONTINENT` enum value from the `ethnicity` response property for the response status `200`
  - removed the `BLACK_OR_AFRICAN_AMERICAN` enum value from the `ethnicity` response property for the response status `200`
  - removed the `CIVIL_PARTNERSHIP` enum value from the `marital_status` response property for the response status `200`
  - removed the `COMMON_LAW` enum value from the `marital_status` response property for the response status `200`
  - removed the `DECEASED` enum value from the `employment_status` response property for the response status `200`
  - removed the `DIVORCED` enum value from the `marital_status` response property for the response status `200`
  - removed the `DOMESTIC_PARTNERSHIP` enum value from the `marital_status` response property for the response status `200`
  - removed the `FEMALE` enum value from the `gender` response property for the response status `200`
  - removed the `HEAD_OF_HOUSEHOLD` enum value from the `marital_status` response property for the response status `200`
  - removed the `HISPANIC_OR_LATINO` enum value from the `ethnicity` response property for the response status `200`
  - removed the `INACTIVE` enum value from the `employment_status` response property for the response status `200`
  - removed the `INACTIVE_EXTERNAL` enum value from the `employment_status` response property for the response status `200`
  - removed the `IN_A_RELATIONSHIP` enum value from the `marital_status` response property for the response status `200`
  - removed the `LEAVE` enum value from the `employment_status` response property for the response status `200`
  - removed the `MALE` enum value from the `gender` response property for the response status `200`
  - removed the `MARRIED` enum value from the `marital_status` response property for the response status `200`
  - removed the `NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER` enum value from the `ethnicity` response property for the response status `200`
  - removed the `NON-BINARY` enum value from the `gender` response property for the response status `200`
  - removed the `OTHER` enum value from the `ethnicity` response property for the response status `200`
  - removed the `OTHER` enum value from the `gender` response property for the response status `200`
  - removed the `OTHER` enum value from the `marital_status` response property for the response status `200`
  - removed the `PENDING` enum value from the `employment_status` response property for the response status `200`
  - removed the `PREFER_NOT_TO_DISCLOSE` enum value from the `ethnicity` response property for the response status `200`
  - removed the `PREFER_NOT_TO_DISCLOSE` enum value from the `gender` response property for the response status `200`
  - removed the `QUALIFYING_WIDOW_OR_WIDOWER_WITH_DEPENDENT_CHILD` enum value from the `marital_status` response property for the response status `200`
  - removed the `RETIRED` enum value from the `employment_status` response property for the response status `200`
  - removed the `SEPARATED` enum value from the `marital_status` response property for the response status `200`
  - removed the `SINGLE` enum value from the `marital_status` response property for the response status `200`
  - removed the `TWO_OR_MORE_RACES` enum value from the `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`: 2 info
  - `query` request parameter `expand` list-of-types was widened by adding types `null`
  - for the `query` request parameter `expand`, the type was generalized from `string` to no type
- **2026-08-12** `47e17f6f9e04`: 1 info
  - added the optional property `work_locations` to the response with the `200` status
- **2026-08-01** `eb3486b88e55`: 4 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 `404`
  - added the non-success response with the status `429`

---

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