---
title: "Get external payrolls for a company"
method: GET
path: "/v1/companies/{company_uuid}/external_payrolls"
tags: ["External Payrolls"]
---

# Get external payrolls for a company

`GET /v1/companies/{company_uuid}/external_payrolls`

Get external payrolls for a company.

scope: `external_payrolls:read`

## Path parameters

- `company_uuid` string, required

## Query parameters

- `page` integer
- `per` integer

## Headers

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

## Response `200`

Success

- ExternalPayrollBasic[]
  - `uuid` string, required — The UUID of the external payroll.
  - `company_uuid` string — The UUID of the company.
  - `check_date` string — External payroll's check date.
  - `payment_period_start_date` string — External payroll's pay period start date.
  - `payment_period_end_date` string — External payroll's pay period end date.
  - `status` 'unprocessed' | 'processed' — The status of the external payroll. The status will be `unprocessed` when the external payroll is created and transition to `processed` once tax liabilities are entered and finalized. Once in the `processed` status all actions that can edit an external payroll will be disabled.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

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