[DEPRECATED] Get W-2 Preview Report

Returns a preview of W-2 data for all employees as of the current date for a specified year.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

Note: this API is slated for deprecation by 12/31/2025. This report is being replaced by the Employee Tax Statements API and the TaxPackage object.

W-2 preview reports enable employers and employees to preview the data which will be filed in employee W-2s at year end. This report is available as a JSON response, a CSV, an individual employee PDF, or, for employers with <=50 employees, as a single PDF packet.

📘

A PDF packet can be generated for companies with 50 or fewer employees

Companies with 50 or fewer employees can download one file containing all of their employees' PDF previews.

You can query for a list of employees paid in the year by making a request for a JSON response from the W-2 preview endpoint.

Path Params
string
required

Returns employee W-2 data for this company ID

Query Params
string
Defaults to current year

Returns employee W-2 data related to this year (defaults to current year).

boolean
Defaults to false

Includes employee IDs in response. Applies to JSON responses only.

string

Returns employee W-2 data for the specified employee ID. Applies to PDF responses only.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json