Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Reports

Create an employees annual FICA wage report

Generates a report containing annual FICA (Federal Insurance Contributions Act) wage data for all employees in a company over a specified year range.

This report provides detailed wage information subject to Social Security and Medicare taxes, useful for benefits integrations that need to verify employee earnings for compliance and benefit calculations.

The report is generated asynchronously. After making this request, you will receive a request_uuid which can be used to poll the Get a report endpoint to check the status and retrieve the report when complete.

scope: company_reports:write

post/v1/companies/{company_id}/reports/employees_annual_fica_wage

Path parameters

company_idstring required

The UUID of the company

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.

Request body

start_yearinteger required

The start year for the report (must be 2011 or later)

end_yearinteger required

The end year for the report (must be the current year or earlier, and must be >= start_year)

Example request

{
  "start_year": 2023,
  "end_year": 2024
}

Response

accepted

request_uuidstring uuid required

The UUID of the report request. Use this to poll for report completion.

company_uuidstring uuid required

The UUID of the company.

start_yearinteger required

The start year for the report.

end_yearinteger required

The end year for the report.