---
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`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_id}/contractor_payments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_id/contractor_payments/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)