Skip to main content
Version: 1.7.1


Form W-2G is used to report certain gambling winnings during a given tax year. The types of gambling activities included in this form are horse racing, dog racing, sweepstakes, wagering pools, lotteries, bingo and slot machine winnings, and poker tournament winnings.

Services you can avail of through TaxBandits API:

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

Form W2G endpoints:​

You can use the following endpoints to complete the Form W2G filing.


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 W2G 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 W2G.
  • Transmit - To transmit the Form W2G to the IRS.
  • Status - To check the status of the Form W2G 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 W2G Endpoints:

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

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

Form W2G PDF Retrieval​

You can obtain the PDF version of your Form W2G 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 W2G 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 W2G Form PDFs, you can use either RequestPdfURL or GetPDF and not both.

To learn how to retrieve a Form W2G PDF, click here