Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
External Payrolls

Get external payrolls for a company

Get external payrolls for a company.

scope: external_payrolls:read

get/v1/companies/{company_uuid}/external_payrolls

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

pageinteger

The page that is requested. When unspecified, will load all objects unless endpoint forces pagination.

perinteger

Number of objects per page. For majority of endpoints will default to 25

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.