---
title: "List employee's lifecycle status history."
method: GET
path: "/people/{id}/lifecycle"
tags: ["Employee Tables"]
---

# List employee's lifecycle status history.

`GET /people/{id}/lifecycle`

Returns a list of historical lifecycle entries from the lifecycle table for an employee.<br /> <br /> **<b>Required permissions</b>** <br />    In order to access the lifecycle history, the service user making the call must have the following permissions: <br /> **For all the lifecycle table entries**: People's Data > Lifecycle > View selected employees' Lifecycle section histories. <br /> **For the current effective lifecycle entry only**: People's Data > Lifecycle > View selected employees' Lifecycle sections. <br /> **For the employees**: People's Data > Access data for > Make sure the employee is in the list.

## Path parameters

- `id` string, required

## Query parameters

- `includeArchived` boolean

## Response `200`

List of life-cycle history entries.

- LifeCycleEntries
  - `values` LifeCycleEntry[]
    - `id` integer — The ID of the lifecycle entry.
    - `effectiveDate` string, date — The date this entry becomes effective.
    - `status` string — Can be any of the <a href="https://help.hibob.com/hc/en-us/articles/4409776355857#h_01H95TQ2DCZ25SPT6R7CYCC0ZW" trget="_blank">employee lifecycle status in Bob</a> (such as "Hired", "Employed", "Terminated", "Garden leave", "Leave","Parental leave").
    - `employeeStatus` string — This is the employee's **access status**, which is automatically determined when updating the status. It can be "Active", or "Inactive"
    - `workChangeType` string — The type of the change that was performed for this work entry. This will contain the ID of the value from the Change Type list.
    - `change` object — Details of the last change and the ID of the user who updated this entry
      - `reason` string
      - `changedBy` string
      - `changedById` string
    - `creationDate` string, date — The date this entry was created.
    - `reasonType` string — The ID of the 'lifecycleReasonType' list entry
    - `isCurrent` boolean — Is 'true' when this is the effective entry which is currently active.
    - `modificationDate` string, date — The date this entry was modified.
    - `leaveReason` string — Can be any of
    - `endEffectiveDate` string — For entries that are not active - this is the date this entry became not effective.
    - `canBeDeleted` boolean — internal flag
    - `customColumns` object — If the table has custom columns, they will appear here.
  - `restricted_columns` RestrictedColumnsMetadata — Indicates which columns were filtered from the response due to field-level permissions (FLP). This object is only present when FLP is enabled for the company and the service user has partial column permissions. To learn more, see <a href="https://apidocs.hibob.com/docs/employee-data-api-field-level-permissions#detecting-restricted-columns-in-api-responses" target="_blank">Field level permissions</a>.
    - `no_view_permission` string[] — Columns filtered because the service user lacks View permission for these fields.
    - `no_view_history_permission` string[] — Columns filtered because the service user lacks View History permission. Only present for historical tables (work, employment, salaries, lifecycle).

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)