improved
v2025-06-15
23 days ago by Gusto Developer Relations
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
:
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
- Added automatic pagination
- '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.
- Added automatic pagination
- ‘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
- Previously, this would return a
- Returns a