---
title: "Get contractor payments for a company"
method: GET
path: "/v1/companies/{company_id}/contractor_payments"
tags: ["Contractor Payments"]
---

# Get contractor payments for a company

`GET /v1/companies/{company_id}/contractor_payments`

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`

## Path parameters

- `company_id` string, required

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `contractor_uuid` string
- `group_by_date` boolean
- `page` integer
- `per` integer

## Headers

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

## Response `200`

A JSON object containing contractor payments information

- union
  - ContractorPaymentSummary — The representation of the summary of contractor payments for a given company in a given time period.
    - `total` object — The wage and reimbursement totals for all contractor payments within a given time period.
      - `reimbursements` string, float — The total reimbursements for contractor payments within a given time period.
      - `wages` string, float — The total wages for contractor payments within a given time period.
    - `contractor_payments` object[] — The individual contractor payments, within a given time period, grouped by contractor.
      - `contractor_uuid` number — The UUID of the contractor.
      - `reimbursement_total` string, float — The total reimbursements for the contractor within a given time period.
      - `wage_total` string, float — The total wages for the contractor within a given time period.
      - `payments` ContractorPayment[] — The contractor's payments within a given time period.
        - `uuid` string, required — The unique identifier of the contractor payment in Gusto.
        - `contractor_uuid` string — The UUID of the contractor.
        - `bonus` string, float — The bonus amount in the payment.
        - `date` string — The payment date.
        - `hours` string, float — The number of hours worked for the payment.
        - `payment_method` 'Direct Deposit' | 'Check' | 'Historical Payment' | 'Correction Payment' — The payment method.
        - `reimbursement` string, float — The reimbursement amount in the payment.
        - `status` 'Funded' | 'Unfunded' — Contractor payment status
        - `hourly_rate` string, float — The rate per hour worked for the payment.
        - `may_cancel` boolean — Determine if the contractor payment can be cancelled.
        - `wage` string, float — The fixed wage of the payment, regardless of hours worked.
        - `wage_type` 'Hourly' | 'Fixed' — The wage type for the payment.
        - `wage_total` string, float — (hours * hourly_rate) + wage + bonus
        - `invoice_number` string, nullable — An optional invoice number associated with this contractor payment. This will be visible to the contractor on their paystub. Maximum 25 characters.
        - `memo` string, nullable — An optional note or memo for this contractor payment. This will be visible to the contractor on their paystub.
  - ContractorPaymentSummaryByDates — The representation of the summary of contractor payments for a given company in a given time period.
    - `total` object — The wage and reimbursement totals for all contractor payments within a given time period.
      - `reimbursements` string, float — The total reimbursements for contractor payments within a given time period.
      - `wages` string, float — The total wages for contractor payments within a given time period.
    - `contractor_payments` object[] — The individual contractor payments, within a given time period, grouped by check date.
      - `contractor_uuid` string — The UUID of the contractor.
      - `check_date` string — The payment check date.
      - `reimbursement_total` string, float — The total reimbursements for the contractor within a given time period.
      - `wage_total` string, float — The total wages for the contractor within a given time period.
      - `payments` ContractorPayment[] — The contractor's payments within a given time period.
        - `uuid` string, required — The unique identifier of the contractor payment in Gusto.
        - `contractor_uuid` string — The UUID of the contractor.
        - `bonus` string, float — The bonus amount in the payment.
        - `date` string — The payment date.
        - `hours` string, float — The number of hours worked for the payment.
        - `payment_method` 'Direct Deposit' | 'Check' | 'Historical Payment' | 'Correction Payment' — The payment method.
        - `reimbursement` string, float — The reimbursement amount in the payment.
        - `status` 'Funded' | 'Unfunded' — Contractor payment status
        - `hourly_rate` string, float — The rate per hour worked for the payment.
        - `may_cancel` boolean — Determine if the contractor payment can be cancelled.
        - `wage` string, float — The fixed wage of the payment, regardless of hours worked.
        - `wage_type` 'Hourly' | 'Fixed' — The wage type for the payment.
        - `wage_total` string, float — (hours * hourly_rate) + wage + bonus
        - `invoice_number` string, nullable — An optional invoice number associated with this contractor payment. This will be visible to the contractor on their paystub. Maximum 25 characters.
        - `memo` string, nullable — An optional note or memo for this contractor payment. This will be visible to the contractor on their paystub.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided ID/UUID is valid.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)