---
title: "Preview contractor payment debit date"
method: GET
path: "/v1/companies/{company_uuid}/contractor_payments/preview"
tags: ["Contractor Payments"]
---

# Preview contractor payment debit date

`GET /v1/companies/{company_uuid}/contractor_payments/preview`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/contractor_payments/preview`
- Auth: HTTP bearer

Returns a debit_date dependent on the ACH payment speed of the company.

If the payment method is Check or Historical payment, the debit_date will be the same as the check_date.

scope: `payrolls:read`

## Path parameters

- `company_uuid` string, required

## Headers

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

## Request body

- ContractorPaymentsPreviewBody: Request body for previewing contractor payments. The expected debit date for the payments is calculated from the provided check date and the company's ACH speed.
  - `contractor_payments` object[], required: A list of contractor payments to preview.
    - `contractor_uuid` string: The contractor receiving the payment.
    - `date` string: Date of the contractor payment (check date).
    - `payment_method` 'Direct Deposit' | 'Check' | 'Historical Payment': The payment method.
    - `wage` string, float: Fixed wage amount for the payment.
    - `hours` string, float: Number of hours worked for the payment.
    - `bonus` string, float: Bonus amount for the payment.
    - `reimbursement` string, float: Reimbursement amount for the payment.

## Response `200`

OK

- ContractorPaymentsPreview: The expected debit date computed for a set of previewed contractor payments.
  - `expected_debit_date` string, date: The calculated debit date. If the payment method is Direct Deposit, the debit date will account for the company's ACH speed. If the payment method is Check, the debit date will be the same as the check date.

## 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.

## Changes

- **2026-11-03** `f98575fa2a5e`: 4 breaking, 1 warning
  - the `contractor_payments/items/bonus` request property type changed from `integer` to `string`, and format from no format to `float`
  - the `contractor_payments/items/hours` request property type changed from `integer` to `string`, and format from no format to `float`
  - the `contractor_payments/items/reimbursement` request property type changed from `integer` to `string`, and format from no format to `float`
  - the `contractor_payments/items/wage` request property type changed from `integer` to `string`, and format from no format to `float`
  - …1 more

[Operation history](https://skmtc.dev/gusto/apis/gusto-api/changes/v1/companies/:company_uuid/contractor_payments/preview/get.md)

---

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