Discussions

Ask a Question
Back to All

Fetching (very) large amounts of employees via /company/employees

Hi there! As part of our Personio integration, our customers can fetch all the employees from their Personio instance. We rely on the /company/employees endpoint and allowlist relevant attributes to reduce the amount of data we request from the Personio API.

We figured out that, when relying on pagination with the offset and limit parameters, we can fetch employees in pages with up to 200 entries each. However, when completely omitting offset and limit parameters, calls to /company/employees seem to return more than 200 entries.

Our question is: how many entries, at most, will a call to /company/employees return, if we don't rely on pagination? Will it return all entries, even if they are in the thousands? Or is there an undocumented limit, which will necessitate the use of pagination?