Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
External Payrolls

Get an external payroll

Get an external payroll for a given company.

scope: external_payrolls:read

get/v1/companies/{company_uuid}/external_payrolls/{external_payroll_id}

Path parameters

company_uuidstring required

The UUID of the company

external_payroll_idstring required

The UUID of the external payroll

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

uuidstring required

The UUID of the external payroll.

company_uuidstring

The UUID of the company.

check_datestring

External payroll's check date.

payment_period_start_datestring

External payroll's pay period start date.

payment_period_end_datestring

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.