Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractor Payments

Get contractor payments

Returns a paginated list of payments for a single contractor.

Results are sortable by check_date or created_at. Append :asc or :desc to control direction (e.g., check_date:desc).

scope: contractor_pay_stubs:read

get/v1/contractors/{contractor_uuid}/payments

Path parameters

contractor_uuidstring required

The UUID of the contractor

Query parameters

sort_bystring

Sort the results. Format: field or field:direction where field is check_date or created_at and direction is asc or desc.

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 array of contractor payments

uuidstring required

The unique identifier of the contractor payment in Gusto.

check_datestring date

The check date for the payment.

bonusstring float

The bonus amount in the payment.

hoursstring float

The number of hours worked for the payment.

hourly_ratestring float

The rate per hour worked for the payment.

payment_method'Direct Deposit' | 'Check' | 'Historical Payment' | 'Correction Payment'

The payment method.

reimbursementstring float

The reimbursement amount in the payment.

status'Funded' | 'Unfunded'

Contractor payment status

wagestring float

The fixed wage of the payment, regardless of hours worked.

wage_type'Hourly' | 'Fixed'

The wage type for the payment.

wage_totalstring float

(hours * hourly_rate) + wage + bonus