---
title: "Get contractor payments"
method: GET
path: "/v1/contractors/{contractor_uuid}/payments"
tags: ["Contractor Payments"]
---

# Get contractor payments

`GET /v1/contractors/{contractor_uuid}/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`

## Path parameters

- `contractor_uuid` string, required

## Query parameters

- `sort_by` string
- `page` integer
- `per` integer

## Headers

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

## Response `200`

A JSON array of contractor payments

- ContractorPaymentListing[]
  - `uuid` string, required — The unique identifier of the contractor payment in Gusto.
  - `check_date` string, date — The check date for the payment.
  - `bonus` string, float — The bonus amount in the payment.
  - `hours` string, float — The number of hours worked for the payment.
  - `hourly_rate` string, float — The rate per hour 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
  - `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

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[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)