---
title: "List contractor payment details"
method: GET
path: "/v1/companies/{company_id}/contractors/payment_details"
tags: ["Contractors"]
---

# List contractor payment details

`GET /v1/companies/{company_id}/contractors/payment_details`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_id}/contractors/payment_details`
- Auth: HTTP bearer

Get payment details for contractors in a company. This endpoint returns a list of all contractors
associated with the specified company, including their payment methods and bank account details
if they are paid via direct deposit.

For contractors paid by direct deposit, the response includes their bank account information
with sensitive data masked for security. The payment details also include information about
how their payments are split if they have multiple bank accounts configured.

For contractors paid by check, only the basic payment method information is returned.

### Response Details
- For direct deposit contractors:
  - Bank account details (masked)
  - Payment splits configuration
  - Routing numbers
  - Account types
- For check payments:
  - Basic payment method designation

### Common Use Cases
- Fetching contractor payment information for payroll processing
- Verifying contractor payment methods
- Reviewing payment split configurations

`encrypted_account_number` is available only with the additional scope `contractor_payment_methods:read:account_numbers`.

scope: `contractor_payment_methods:read`

## Path parameters

- `company_id` string, required

## Query parameters

- `contractor_uuid` string
- `contractor_payment_group_uuid` string

## Headers

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

## Response `200`

successful

- object[]
  - `contractor_uuid` string
  - `payment_method` 'Direct Deposit' | 'Check'
  - `first_name` string
  - `last_name` string
  - `split_by` 'Amount' | 'Percentage', nullable: Describes how the payment will be split. If split_by is Percentage, then the split amounts must add up to exactly 100. If split_by is Amount, then the amount represents cents and the last split amount must be `null` to capture the remainder.
  - `splits` object[], nullable
    - `bank_account_uuid` string
    - `name` string
    - `hidden_account_number` string: An obfuscated version of the account number which can be used for display purposes.
    - `encrypted_account_number` string, nullable: Ciphertext containing the full bank account number, which must be decrypted using a key provided by Gusto. Only visible with the `contractor_payment_methods:read:account_number` scope.
    - `routing_number` string
    - `priority` integer: The order of priority for each payment split, with priority 1 being the first bank account paid. Priority must be unique and sequential.
    - `split_amount` number, nullable: If `split_by` is 'Amount', this is in cents (e.g., 500 for $5.00) and exactly one account must have a `split_amount` of `null` to capture the remainder. If `split_by` is 'Percentage', this is the percentage value (e.g., 60 for 60%).
    - `account_type` string

## Other responses

- `404`: Not Found

---

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