v2025-06-15

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

v2024-04-01 has entered the year-long deprecation process effective June 15 2025, and it will have Full Support for 6 months (June 15 2025—December 15 2025) and Limited Support for the following 6 months (December 15 2025—June 15 2026). After June 15 2026, v2024-04-01 will be fully retired and unusable.

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