---
title: "Get employee payment details for a company"
method: GET
path: "/v1/companies/{company_id}/employees/payment_details"
tags: ["Employees"]
---

# Get employee payment details for a company

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

Fetches payment details for employees in a given company. Results are paginated.

Use the `employee_uuid` query parameter to filter for a single employee.
Use the `payroll_uuid` query parameter to filter for employees on a specific payroll.
Providing both `employee_uuid` and `payroll_uuid` will result in a 422 error.
An empty array is returned if the company has no employees or if no employees match the filter criteria.

The `encrypted_account_number` in the `splits` array is only visible if the `employee_payment_methods:read:account_number` scope is present.

scope: `employee_payment_methods:read`

## Path parameters

- `company_id` string, required

## Query parameters

- `employee_uuid` string
- `payroll_uuid` string
- `page` integer
- `per` integer

## Headers

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

## Response `200`

A list of employee payment details.

- object[] — A list of employee payment details.
  - `employee_uuid` string — The UUID of the employee.
  - `first_name` string — The legal first name of the employee.
  - `last_name` string — The last name of the employee.
  - `payment_method` 'Direct Deposit' | 'Check' — The type of payment method.
  - `split_by` 'Amount' | 'Percentage', nullable — How the payment is split. This field is applicable when `payment_method` is "Direct Deposit". If `split_by` is Percentage, then the split amounts must add up to exactly 100. If `split_by` is Amount, the last split amount must be `null` to capture the remainder.
  - `splits` object[], nullable — An array of payment splits. This field is applicable when `payment_method` is "Direct Deposit".
    - `bank_account_uuid` string — The UUID of the bank account.
    - `name` string — The name of the bank account.
    - `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 `employee_payment_methods:read:account_number` scope.
    - `routing_number` string — The routing number of the bank account.
    - `account_type` string — The bank account type (e.g., "Checking" or "Savings").
    - `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%).

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