Skip to main content
Version: 1.7.3

Overview

If you notice any mistakes on your W-2G forms after submission, you must file corrections to ensure accurate reporting with the IRS and/or states.

With the TaxBandits API, you can file a correction for W-2G forms even if the original return was filed elsewhere. However, in order to do so, the IRS must have accepted the previously filed correction. Learn more about W-2G corrections.

Services offered by TaxBandits API​

  • Federal & State Filing - E-file Form W-2G corrections with both the IRS and States.
  • Postal Mailing - Distribute the recipient copy of Form W-2G correction via Postal Mail.
  • Online Access - Make the digital copies of Form W-2 available online for the corresponding recipients.

How to file Form W-2G corrections​

You can use the following endpoints to complete the Form W-2G correction filing.

  • Create - Used to create a new Form W-2G correction.
  • Update - Used to make changes to an existing W-2G form correction created in TaxBandits.
  • Transmit - Used to transmit the Form W-2G correction to the IRS and/or states.

State corrections​

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

Currently, you can directly file state corrections through TaxBandits for the following states:

  • Alabama (AL)
  • Arizona (AZ)
  • Arkansas (AR)
  • Georgia (GA)
  • Idaho (ID)
  • Kansas (KS)
  • Maine (ME)
  • Maryland (MD)
  • Missouri (MO)
  • Montana (MT)
  • North Dakota (ND)
  • Oklahoma (OK)
  • Virginia (VA)
  • West Virginia (WV)
  • Wisconsin (WI)

For all other states, you can make corrections, download the state copies, and file them with the respective state authorities.

PDF retrieval​

You can obtain the PDF version of your W-2G forms using one of the following endpoints:

  • RequestDraftPdfUrl - Used to return the draft PDF for review purposes. These forms are not for filing and will have a watermark "For Review only" on them.
  • RequestPdfURL - Used to retrieve PDF URLs for single or multiple recipients.
  • GetPDF - Used to get the link for the W-2G correction form PDF. To use this, you must have configured webhooks for it so that the endpoint will return the PDFs via Webhook.
info

ℹ️ To retrieve the final version of Form W-2G correction PDFs, you can use either RequestPdfURL or GetPDF.

Status retrieval​

You can retrieve the status of your W-2G correction in two ways:

  • Status - Use this endpoint to retrieve the status of the W-2G correction submitted to the IRS and/or states.
  • Webhooks - You can configure webhooks for the following event types to receive Form W-2G correction status updates.
  • E-file Status Change - You will be notified when the SSA accepts or rejects your Form W-2G correction. Learn More
  • E-File State Status Change - You will be notified when the state accepts or rejects your Form W-2G correction. Learn More
  • Postal Sent - You will be notified when the Form W-2G corrections are mailed to the recipients. Learn More
  • Online Access Status Change - You will be notified when the W-2G correction forms are shared with recipients via online access, when recipients provide consent, and when they access the forms. Learn More

Other endpoints​

  • ValidateForm - Used to validate the field-level specifications of W-2G correction before creating the form. (Optional)
  • Validate - Used to audit the created W-2G correction form before transmission to the SSA.
  • List - Used to list all W-2G correction forms for a submission or Payer.
  • Get - Used to retrieve the recipient data, business data, and form data from the W-2G correction form created.
  • Delete - Used to delete the W-2G correction form you prepared in TaxBandits before transmitting.