---
title: "Get an external payroll"
method: GET
path: "/v1/companies/{company_uuid}/external_payrolls/{external_payroll_id}"
tags: ["External Payrolls"]
---

# Get an external payroll

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

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/external_payrolls/{external_payroll_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/external_payrolls/:external_payroll_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an external payroll for a given company.

scope: `external_payrolls:read`

## Path parameters

- `company_uuid` string, required
- `external_payroll_id` string, required

## Headers

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

## Response `200`

Success

- ExternalPayroll: The representation of an external payroll.
  - `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.
  - `external_payroll_items` object[]: External payroll items for employees
    - `employee_uuid` string
    - `earnings` object[]
      - `amount` string, float
      - `hours` string, float
      - `earning_type` string
      - `earning_id` integer
    - `benefits` object[]
      - `benefit_id` integer
      - `company_contribution_amount` string, float
      - `employee_deduction_amount` string, float
    - `taxes` object[]
      - `tax_id` integer
      - `amount` string, float
  - `applicable_earnings` object[]: Applicable earnings based on company provisioning.
    - `earning_type` string
    - `earning_id` number
    - `name` string
    - `input_type` string
    - `category` string
  - `applicable_benefits` object[], nullable: Applicable benefits based on company provisioning.
    - `id` integer
    - `description` string
    - `active` boolean
  - `applicable_taxes` object[]: Applicable taxes based on company provisioning.
    - `id` integer
    - `name` string
    - `employer_tax` boolean: Some taxes may have an amount withheld from the employee and an amount withheld from the employer, e.g. Social Security. A `true` value indicates this is the employer's amount.
    - `resident_tax` boolean: Some taxes may have different rates or reporting requirements depending on if the employee is a resident or non-resident of the tax jurisdiction.
  - `metadata` object: Stores metadata of the external payroll.
    - `deletable` boolean: Determines if the external payroll can be deleted.

## Other responses

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

---

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