v2025-06-15

To further improve performance of our payroll API endpoints, v2025-06-15 introduces the changes outlined below.

If after 2 weeks v2025-06-15 proves stable, we will provide another update in which we mark it as stable and we enter v2024-04-01 into the year-long deprecation process, with Full Support for 6 months and Limited Support for the following 6 months.

Changes in v2025-06-15:

• The maximum page size for all payroll endpoints is 100 items
• ‘Get a single payroll’
  • Added automatic pagination
    • Default page size: 25 employee compensations
    • Default page number: 1
    • Added a maximum page size of 100 employee compensations
• 'Get all payrolls for a company'
  • Added a maximum page size of 100 payrolls
• ‘Prepare a payroll for update’
  • Added automatic pagination
    • Default page size: 25 employee compensations
    • Default page number: 1
    • Added a maximum page size of 100 employee compensations.
• ‘Update a payroll by ID’
  • Updated to only return employee compensations included in the request
  • Added a maximum input size of 100 employee compensations
• ‘Preview a contractor payment group’ now always returns a creation_token, which is a required body parameter for the ‘Create a contractor payment group’ endpoint.
• ‘Get an employee rehire’’
  • Returns a 204 when passing in a valid employee UUID but no rehires are found
    • Previously, this would return a 404