Returns a list of historical employment entries from the employment table for all employees or a specific list of employees.

Each employment entry includes the working pattern assigned to this employee. To learn more about working patterns, see How to work with Working patterns.

Required permissions

In order to access the employment history of each requested employee, the service user making the call must have the following permissions:

For all the employment table entries: People's Data > Employment > View selected employees' Employment section histories.

For the current effective employment entry only: People's Data > Employment > View selected employees' Employment sections.

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.

Pagination

This endpoint uses cursor-based pagination to handle large number of table entries. To learn more, see Pagination in Bob's API.

200Successful response. Please note that the item ID may be textual or numeric depending on the list type.