GetPDF

GetPDF

This endpoint retrieves the generated Form W-3 PDF for a specified business and tax year.

Form W-3, Transmittal of Wage and Tax Statements, is used to summarize the wage and tax information reported on the associated Forms W-2. It includes aggregate totals for wages, tips, other compensation, federal income tax withheld, Social Security and Medicare wages and taxes, and other applicable amounts.

This endpoint can be used to generate and retrieve a PDF copy of Form W-3 for the specified business and tax year. The response includes the generated Form W-3 PDF in byte array format, along with the total number of attachments associated with the request.

POST FormW3/GetPDF 

Run in Postman

Request Body

Field	Type	Description
TaxYear	string	Tax Year you want to generate the Form W3. Allowed values "2025", "2026"
BusinessId	GUID	Optional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed. Allowed values "PLAIN_TIN" - Pass TIN directly. "TOKENIZED_TIN" - Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN"
TIN	string	The TIN value according to the Format selected.

Response Body

Field	Type	Description
TaxYear	string	Tax year of Form W-3 generated.
BusinessId	GUID	Unique identifier of the business.
AttachmentCount	string	Total number of Form W-3 PDFs generated.
AttachmentW3	byte[]	Byte array of Form W-3 PDF.
Errors	object[]	Shows detailed error information.
Code	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Type	string	Type of validation error.

Request JSON

{
  "TaxYear": "2026",
  "BusinessId": "334a57d5-efc5-409a-9bbf-28f3abda0c7f",
  "TINDetails": {
    "Format": "PLAIN_TIN",
    "TINType": "EIN",
    "TIN": "72-5564875"
  }
}

Response JSON

Success Response - This is a sample response for successful API requests.

{
  "TaxYear": "2026",
  "BusinessId": "334a57d5-efc5-409a-9bbf-28f3abda0c7f",
  "AttachmentCount": "1",
  "AttachmentW3": "JVBERi0xLjMKJcOHw6zCj8KiCjEgMCBvYmoKPDwvVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKL0Fjcm9Gb3JtIDQgMCBSCi9NZXRhZGF0YSA3IDAgUgo+PgplbmRvYmoKCjIgMCBvYmoKPDwvVHlwZSAvUGFnZXMKL0tpZHM",
  "Errors": null
}