Get contractor payments for a company

GET {{baseUrl}}/v1/companies/:company_id/contractor_payments?start_date=<string>&end_date=<string>&contractor_uuid=<string>&group_by_date=<boolean>&page=<number>&per=<number>

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

scope: payrolls:read

Request Params

KeyDatatypeRequiredDescription
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_uuidstringThe UUID of the contractor. When specified, will load all payments for that contractor.
group_by_datestringDisplay contractor payments results group by check date if set to true.
pagestringThe page that is requested. When unspecified, will load all objects unless endpoint forces pagination.
perstringNumber of objects per page. For majority of endpoints will default to 25

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Acceptstring

RESPONSES

status: OK

{&quot;total&quot;:{&quot;reimbursements&quot;:&quot;110.0&quot;,&quot;wages&quot;:&quot;1840.0&quot;},&quot;contractor_payments&quot;:[{&quot;contractor_id&quot;:1234,&quot;reimbursement_total&quot;:&quot;110.0&quot;,&quot;wage_total&quot;:&quot;1840.0&quot;,&quot;payments&quot;:[{&quot;id&quot;:&quot;04552eb9-7829-4b18-ae96-6983552948df&quot;,&quot;bonus&quot;:&quot;20.0&quot;,&quot;date&quot;:&quot;2020-10-19&quot;,&quot;hours&quot;:&quot;40.0&quot;,&quot;payment_method&quot;:&quot;Direct Deposit&quot;,&quot;reimbursement&quot;:&quot;100.0&quot;,&quot;hourly_rate&quot;:&quot;18.0&quot;,&quot;may_cancel&quot;:true,&quot;wage&quot;:&quot;0.0&quot;,&quot;wage_type&quot;:&quot;Hourly&quot;,&quot;wage_total&quot;:&quot;740.00&quot;,&quot;contractor_id&quot;:1234,&quot;contractor_uuid&quot;:&quot;bc57832c-d8bc-43a7-ae99-3a03380ff037&quot;},{&quot;id&quot;:&quot;25cfeb96-17fc-4fdf-8941-57f3fb9eea00&quot;,&quot;bonus&quot;:&quot;100.0&quot;,&quot;date&quot;:&quot;2020-10-19&quot;,&quot;hours&quot;:&quot;0.00&quot;,&quot;payment_method&quot;:&quot;Direct Deposit&quot;,&quot;reimbursement&quot;:&quot;10.0&quot;,&quot;hourly_rate&quot;:&quot;0.0&quot;,&quot;may_cancel&quot;:true,&quot;wage&quot;:&quot;1000.0&quot;,&quot;wage_type&quot;:&quot;Fixed&quot;,&quot;wage_total&quot;:&quot;1100.0&quot;,&quot;contractor_id&quot;:1234,&quot;contractor_uuid&quot;:&quot;bc57832c-d8bc-43a7-ae99-3a03380ff037&quot;}]}]}