---
title: "List work history for a list of employees"
method: GET
path: "/bulk/people/work"
tags: ["Employee Tables"]
---

# List work history for a list of employees

`GET /bulk/people/work`

Returns a list of historical work entries from the work table for all employees or a specific list of employees.<br /> <br /> **<b>Required permissions</b>** <br />    In order to access the work history of each requested employee, the service user making the call must have the following permissions: <br /> **For all the work table entries**: People's Data > Work > View selected employees' Work section histories. <br /> **For the current effective work entry only**: People's Data > Work > View selected employees' Work sections. <br /> **For the employees**: People's Data > Access data for > Make sure the employees are in the list. Employees that are not listed and were specifically requested will be listed under `errors` in the response. <br /> <br />
**<b>Pagination</b>** <br /> This endpoint uses cursor-based pagination to handle large number of table entries. To learn more, see <a href="https://apidocs.hibob.com/docs/pagination" target=”_blank”>Pagination in Bob's API</a>

## Query parameters

- `limit` number
- `cursor` string
- `employeeIds` string
- `includeArchived` boolean

## Response `200`

Work table entries.

- BulkWorkTableResponse
  - `results` object[]
    - `employeeId` string
    - `values` WorkEntries[]
      - `values` WorkEntryForGet[]
        - `canBeDeleted` boolean — internal flag
        - `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
        - `reportsTo` object
          - `id` string, required — The manager's employee ID (the email of the manager or a custom field containing the ID).
          - `firstName` string — The manager's first name.
          - `surname` string — The manager's surname.
          - `email` string — The manager's email address.
          - `displayName` string — The manager's display name.
        - `creationDate` string, date — The date this entry was created effective.
        - `title` string — The job title of the employee for this work entry. This field containe the ID of the job title entry from the job title list.
        - `customColumns` object
        - `isCurrent` boolean — An indication whether this is the current active entry.
        - `modificationDate` string, date — The date this entry was created effective.
        - `site` string — The site of the employee.
        - `siteId` integer — The id of the site of the employee.
        - `id` integer — The id of the entry.
        - `endEffectiveDate` string, date — For entries that are not active - this is the date this entry became not effective.
        - `activeEffectiveDate` string, date — The active effective date for this entry.
        - `department` string — The department the employee belonged to for this work entry. This field should contain the ID of the department entry in department list.
        - `effectiveDate` string, date — The date this entry becomes effective. This is a mandatory field for a work entry.
      - `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).
  - `response_metadata` object
    - `next_cursor` string — Contains a string value if there is a 'next' page of data. `null` if there is no more data. Use this value as the `cursor` parameter for pagination to get the next page.
  - `errors` object[]
    - `employeeId` object
      - `error` string
      - `message` string

## Other responses

- `400` — Bad request.
- `403` — Forbidden. The service user does not have permissions to access this table or employees. Check the permissions as explained in the endpoint description.

---

[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/revisions/0781ebbdda91/schema)