--- updatedAt: 2026-03-29T09:48:05.000Z --- Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further. # Employee Tables The Employee Tables API provides access to the details of your company employees's data tables. Employee tables endpoints provide access to table entries of employees' historical data and other types of information stored in tables holding multiple rows. # Reading employee tables Employee data includes tables that store several entries of data per employee. To access data stored in the employee table entries, use the employee tables endpoints below. Before you start, explore [How to read employee data](https://apidocs.hibob.com/docs/how-to-read-employee-data) to learn how to map the fields and their properties and how to process the response payload. # Required Permissions In Bob, employee tables are systematically organized within categories. This means that when you enable permissions to the Service User you enable the permission to the category and as a result, to all the tables that reside in that category. Before accessing a table, ensure the service user has permissions to access the **relevant category**, just like you would do with a user within Bob. For example, if you need the service user to pull employee work history, you would set permissions to: * People’s data permissions: * **People > Work > View selected employees' Work section histories**\ (this gives you access to all the rows in the table) * **People > Work > View selected employees' Work sections**\ (this gives you access to the current effective row) * Access rights permissions: * Select “Everyone” (if you need to access all employees). * Or include the employee in the list of selected users. To learn more, see [Categories and Permissions](https://apidocs.hibob.com/docs/categories-and-permissions). To learn more about permissions, see [Setting permissions to Service Users](https://apidocs.hibob.com/docs/api-service-users#step-3-set-permissions-to-the-permissions-group) . **Note**: When field-level permissions (FLP) are enabled and the service user has partial column access, the response includes a `restricted_columns` object indicating which columns were filtered. See [Field level permissions](https://apidocs.hibob.com/docs/employee-data-api-field-level-permissions#detecting-restricted-columns-in-api-responses) for details. # Pagination Some of the endpoints use cursor-based pagination to go through the results. It's the fastest and most reliable way to handle a large number of items. To learn more, see [Pagination in Bob's API](https://apidocs.hibob.com/docs/pagination). # Rate limiting Rate limits are restrictions that our API imposes on the number of times a user can access our endpoints within a specified period of time. To learn more about rate limiting best practices, see [Rate limiting](https://apidocs.hibob.com/docs/rate-limit). Below is a table detailing the rate limits for each endpoint in the Employee tables endpoints. | Method | Endpoint | Limit per minute | | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------- | | GET | [List work history for a list of employees](https://apidocs.hibob.com/reference/get_bulk-people-work) | 100 | | GET | [List the lifecycle history for a list of employees](https://apidocs.hibob.com/reference/get_bulk-people-lifecycle) | 100 | | GET | [List employment history for a list of employees.](https://apidocs.hibob.com/reference/get_bulk-people-employment) | 100 | | GET | [List payroll history (salaries) for a list of employees.](https://apidocs.hibob.com/reference/get_bulk-people-salaries) | 100 | | GET | [List employee's employment history](https://apidocs.hibob.com/reference/get_people-id-employment) | 50 | | POST | [Creates a new employment entry for a given employee](https://apidocs.hibob.com/reference/post_people-id-employment) | 10 | | PUT | [Update an employment entry from a given employee's employment history](https://apidocs.hibob.com/reference/put_people-id-employment-entry-id) | 10 | | GET | [List employee's work history](https://apidocs.hibob.com/reference/get_people-id-work) | 50 | | POST | [Create a new work entry for a given employee](https://apidocs.hibob.com/reference/post_people-id-work) | 10 | | PUT | [Update a work entry in the employee's work history table](https://apidocs.hibob.com/reference/put_people-id-work-entry-id) | 10 | | DELETE | [Deletes a work entry from a given employee's work history](https://apidocs.hibob.com/reference/delete_people-id-work-entry-id) | 10 | | GET | [List employee's life-cycle status history](https://apidocs.hibob.com/reference/get_people-id-lifecycle) | 50 | | GET | [List employee's salary history](https://apidocs.hibob.com/reference/get_people-id-salaries) | 10 | | POST | [Creates a new salary entry for a given employee](https://apidocs.hibob.com/reference/post_people-id-salaries) | 10 | | DELETE | [Deletes a salary entry from the employee's list](https://apidocs.hibob.com/reference/delete_people-id-salaries-entry-id) | 10 | | GET | [List the employee's training records](https://apidocs.hibob.com/reference/get_people-id-training) | 50 | | POST | [Creates a new training records for a given employee](https://apidocs.hibob.com/reference/post_people-id-training) | 10 | | DELETE | [Deletes any training records for an employee](https://apidocs.hibob.com/reference/delete_people-id-training-entry-id) | 10 | | GET | [Read payroll history](https://apidocs.hibob.com/reference/get_payroll-history) | 20 | | GET | [List the employee's equity grants](https://apidocs.hibob.com/reference/get_people-id-equities) | 50 | | POST | [Creates a new equity grant for a given employee](https://apidocs.hibob.com/reference/post_people-id-equities) | 10 | | PUT | [Updates an equity grant for an employee](https://apidocs.hibob.com/reference/put_people-id-equities-entry-id) | 10 | | DELETE | [Deletes an equity grant for an employee](https://apidocs.hibob.com/reference/delete_people-id-equities-entry-id) | 10 | | GET | [List employee's variable payments](https://apidocs.hibob.com/reference/get_people-id-variable) | 50 | | POST | [Creates a new variable payment for a given employee](https://apidocs.hibob.com/reference/post_people-id-variable) | 10 | | DELETE | [Deletes a training record for an employee](https://apidocs.hibob.com/reference/delete_people-id-variable-entry-id) | 10 | | GET | [Read all open tasks](https://apidocs.hibob.com/reference/get_tasks) | 50 | | GET | [Read tasks of a specific employee](https://apidocs.hibob.com/reference/get_tasks-people-id) | 50 | | POST | [Search for actual payments](https://apidocs.hibob.com/reference/post_people-actual-payments-search) | 100 | | GET | [List employee's bank accounts](https://apidocs.hibob.com/reference/get_people-id-bank-accounts) | 50 | | POST | [Create a new bank account entry for a given employee.](https://apidocs.hibob.com/reference/post_people-id-bank-accounts) | 10 | | PUT | [Update a bank account entry in the employee's bank accounts table.](https://apidocs.hibob.com/reference/put_people-id-bank-accounts-entry-id) | 10 | | DELETE | [Deletes a bank account entry from a given employee's bank accounts table.](https://apidocs.hibob.com/reference/delete_people-id-bank-accounts-entry-id) | 10 |