Pagination

We support OData pagination using $top and $skip as part of the query string.

curl https://api.urus.co.uk/hr/v2/employees?$skip=250&$top=250 \
-H "authorization: Bearer <access token>" \

Pages are normally returned in batches of 250 records. Less records can be requested per page, but this is a built-in maximum.

You can optionally include a header instead of $top, to override the default page size:

curl https://api.iris.co.uk/hr/v2/employees \
-H "authorization: Bearer <access token>" \
-H "prefer: odata.maxpagesize=1"

When using the $skip as part of the request url, we recommend that you include the $top parameter even if it is set to 250. This is because the default number of returned records could increase in the future.