Skip to main content
Version: 2.0.0

Overview

If you notice any mistakes on your W-2 forms after submission, you must file a W-2C correction to ensure accurate reporting with the SSA and/or states. It is a multi-purpose form, similar to Form W-2, used to report corrected wages and withholding information to the SSA, and applicable state agencies such as the FTB. Common mistakes on W-2 forms include incorrect names, wage amounts, or Social Security Numbers (SSNs).

With the TaxBandits API, you can file a W-2C correction for forms originally filed through TaxBandits or elsewhere, subject to the applicable SSA correction requirements. Learn more about W-2C corrections

Federal/SSA corrections​

You can correct the W-2 form data by providing the previously reported W-2 information in PrevReportedW2FormData and the updated information in CorrectedW2FormData.

If you need to correct the employee’s information, provide the previously reported employee details in PrevReportedEmployeeData and the corrected information in CorrectedEmployeeData

If the original W-2 return was already filed through TaxBandits, you do not need to provide the previously reported W-2 or employee details in PrevReportedW2FormData and PrevReportedEmployeeData. Instead, you can provide the original return’s RecordId in PrevReportedRecordId.

State corrections​

When filing a correction with the state, you must specify the correction type in your request payload in the StateCorrectionType field as VOID, CORRECTION, or NEW, based on the type of information you want to correct:

VOID — The state filing was submitted in error and should not have been processed. CORRECTION — Corrects previously reported amounts or codes. NEW — Adds state information that was not included in the original filing.

Supported Tax Years​

TaxBandits API supports e-filing of Form W2-C correction for the following tax years:

Tax YearAPI Version
2026v2.0.0
2025v2.0.0, v1.7.3
2024v1.7.3

W-2C endpoints​

You can use the following endpoints to complete the W-2C filing.

  • Create — To create a new W-2C form.
  • Update — To make changes to an existing W-2C form created in TaxBandits.
  • Get — Retrieve payer, recipient, and form data for a specific W-2C submission by SubmissionId.
  • ValidateForm — Validate the field-level specifications of W-2C before creating the form.

All endpoints require a Bearer token obtained through the OAuth 2.0 authentication flow. Include this token in the Authorization header of every request. Learn more about OAuth 2.0.

W-2C - Other Utility endpoints​

For all remaining operations, use the common utility endpoints listed below. These endpoints are shared by both original and correction returns. Ensure that the appropriate SubmissionId and other required record identifiers are provided to retrieve the relevant information.

  • List — List all W-2 records (original or correction) for a submission or payer.
  • Status — Retrieve the status of the Forms W-2 submitted to the SSA and/or states.
  • Transmit — Transmit the created return to the SSA.
  • StatusLog — Retrieve the status changes of the transmitted return.
  • RequestDraftPdfUrl — Return a draft PDF URL for review. These forms are not for filing and carry a "For Review only" watermark.
  • RequestPdfURLs — Retrieve final PDF URLs for one or more recipients after transmission.
  • Delete — Delete returns created before they are transmitted.