v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractor Payments

Get contractor payments for a company

Returns an object containing individual contractor payments, within a given time period, including totals.

Results are returned in reverse chronological order (newest first).

scope: payrolls:read

get/v1/companies/{company_id}/contractor_payments

Path parameters

company_idstring required

The UUID of the company

Query parameters

start_datestring required

The time period for which to retrieve contractor payments

end_datestring required

The time period for which to retrieve contractor payments. If left empty, defaults to today's date.

contractor_uuidstring

The UUID of the contractor. When specified, will load all payments for that contractor.

group_by_dateboolean

Display contractor payments results group by check date if set to true.

pageinteger

The page that is requested. When unspecified, will load all objects unless endpoint forces pagination.

perinteger

Number of objects per page. For majority of endpoints will default to 25

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

A JSON object containing contractor payments information

OR