Skip to main content
Version: 1.7.1

Overview

Form W-2 is a wage tax form to report the wages paid to employees and the taxes (social security, income, and Medicare tax) withheld from the employees to the SSA (Social Security Administration). Also, a copy of Form W2 must be furnished to the employees.

Services you can avail of through TaxBandits API:​

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

Form W-2 endpoints:​​

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

note

In order to use the following endpoints, you must call the Auth method to get the access token. This access token must be supplied in the request header as the ‘Bearer‘ token. Refer to OAuth 2.0 Authentication for more information on JWT authentication.

  • Create - To create Form W-2 for the recipients under the corresponding payer. While creating the form, you can opt for state filing, postal mail, and online access if required.
  • Update - To make changes to an existing Form W-2.
  • Transmit - To transmit the Form W-2 to the IRS.
  • Status - To check the status of the Form W-2 after transmission. (As an alternative, you can configure Webhooks for E-file Status Change)

If you need to retrieve Form PDFs, you can use one of the endpoints mentioned here.

Other Form W-2 Endpoints:​

You can use any of the following endpoints based on your needs.

  • ValidateForm - To validate the field-level specifications of Form W-2 before creating the form. (Optional)
  • Validate - To audit the created Form W-2 data before transmission to the IRS.
  • List - To list all Form W-2 for a submission or Payer.
  • Get - To retrieve the recipient data, business data and form data from the Form W-2 created.
  • GetbyRecordIds - To retrieve the recipient data, business data, and form data using the recordids (without submissionid).
  • Delete - To delete the Form W-2 return you prepared in TaxBandits.

Form W-2 PDF Retrieval​​

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

  • RequestDraftPdfUrl - To return the Draft PDF for review purposes. These forms are not transmitted and will have a watermark "For Review only" on it.
  • RequestPdfURLs - To retrieve PDFs for single or multiple recipients.
  • GetPDF - To get the link for Form W-2 PDF. To use this, you must have configured Webhook for it, so that the endpoint will return the PDFs via Webhook.

Note: To retrieve the final version of Form W-2 Form PDFs, you can use either RequestPdfURL or GetPDF and not both.

To learn how to retrieve a Form W-2 PDF, click here