Returns the entries of one custom table for all employees or a specific list of employees, in a single paginated call. The rows have the same shape as the response of Read all entries of the given custom table. Use Read metadata of custom tables defined to get the custom table ID and its columns.
Only custom tables created in Bob are supported. Out-of-the-box employee tables are read with their own /bulk/people/{table} endpoints.
You can fetch employee IDs using the People search endpoint.
Required permissions
People's Data > People's fields > the custom table's category > View (or Edit), or the equivalent permissions on the custom table under People's fields.
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. The limit counts table entries (rows), not employees, so the entries of one employee can span two pages. To learn more, see Pagination in Bob's API
Bad request. For example: limit is above 200, more than 200 employeeIds were passed, or the cursor is not valid.
Forbidden. The service user does not have permissions to access this table. Check the permissions as explained in the endpoint description.
Not found. The custom table does not exist, or the ID belongs to an out-of-the-box employee table, which is read with its own /bulk/people/{table} endpoint.