UploadAttachment

UploadAttachment

This endpoint can be used to attach yearly transaction details or any other supporting documents to your recipients’ 1099-NEC form copies.

How it works

1. Create Form – Generate a 1099-NEC form for the recipient.

2. Upload Transaction Documents – Use the UploadAttachment endpoint against each form to upload additional PDFs for that recipient.

3. Transmit & Distribute – After uploading, call the Transmit endpoint. TaxBandits will deliver the 1099 along with the attached documents (via Postal Mailing and/or Online Access, if enabled).

Key points

• Enable Postal Mailing or Online Access for each recipient.
• Mask TIN details in attachments before uploading.
• Provide either PDFByteArray or FilePath for each RecordId (not both).
• Call the UploadAttachment endpoint before transmitting. Attachments cannot be uploaded afterward.
• If multiple PDFs are uploaded for the same RecordId, the latest upload replaces earlier ones.
• Limits: Up to 100 PDFs or a total of 100 MB per submission. Each ByteArray must not exceed 2 MB.

POST Form1099NEC/UploadAttachment 

Run in Postman

Request Body

Field	Type	Description
SummaryAttachment	Object[]	Object to get the attachment details
RecordID	Guid	A Unique identifier of the records given by TaxBandits
PDFByte	ByteArray	Byte array of the PDF document
FilePath	String	File path of the PDF document

Request Body

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	String	Name of the status code.
StatusMessage	String	Detailed status message.
SuccessRecords	Object	Object contains the success records
RecordID	Guid	A unique Identifier of the records generated by TaxBandits
Info	String	Success records information
ErrorRecords	Object	Object contains the error records.
RecordID	Guid	A unique Identifier of the records generated by TaxBandits
Errors	Object[]	Shows detailed error information.
Id	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

{
   "SummaryAttachment": [
   {
   	"RecordID": "e88e7f1d-7ae5-43b6-99f6-38d85664035a",
   	"PDFByte": "JVBERi0xLjMKJcOHw6zCj8KiCjEgMCBvYmoKPDwvVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCgoyIDAgb2JqCjw8L1R5cGUgL1BhZ2VzCj4+CmVuZG9iagoKMyAwIG9iago8PC9Qcm9kdWNlciAoXS5jZr7J2RzsWMGZesbjnpitsebz7uIEZ5dbRhmC/A6w6QJx87yIZn+lw6h212zv0LgpCj4+CmVuZG9iagoKNCAwIG9iago8PC9GaWx0ZXIgL1N0YW5kYXJkCi9WIDIKL1IgMwovUCAtMTg1MgovTyA8MzY0NTFCRDM5RDc1M0I3QzFEMTA5MjJDMjhFNjY2NUFBNEYzMzUzRkIwMzQ4QjUzNjg5M0UzQjFEQjVDNTc5Qj4KL1UgPDREM0ZCQTBEQTkzNDdGRTdBMDhBRDk0Mzk2OEJBNzM2MzE0MTU5MjY1MzU4OTc5MzIzODQ2MjY0MzM4MzI3OTU+Ci9MZW5ndGggMTI4Cj4+CmVuZG9iagoKeHJlZgowIDUKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE5IDAwMDAwIG4gCjAwMDAwMDAwNjggMDAwMDAgbiAKMDAwMDAwMDEwMiAwMDAwMCBuIAowMDAwMDAwMTg2IDAwMDAwIG4gCnRyYWlsZXIKPDwvU2l6ZSA1Ci9Sb290IDEgMCBSCi9JbmZvIDMgMCBSCi9JRCBbPDU1MUQwRTI4MOUE+XQovRW5jcnlwdCA0IDAgUgo+PgpzdGFydHhyZWYKMzk2CiUlRU9GCg==",
   	"FilePath": null
   },
   {
   	"RecordID": "04ec74ea-9099-42a0-9a64-710a4d7eec37",
   	"PDFByte": null,
   	"FilePath": "https://amazonaws.com/pdfs/a570efbd-740f-4ae2-bfe7-26356cd85148.pdf"
   }
   ]
}

Response JSON

{
	"StatusCode": 200,
	"StatusName": "Ok",
	"StatusMessage": "Successful API Call",
	"SuccessRecords": [
	{
		"RecordID": "e88e7f1d-7ae5-43b6-99f6-38d85664035a",
		"Info": "Attachment Uploaded Successfully"
	},
	{
		"RecordID": "e88e7f1d-7ae5-43b6-99f6-38d85664035a",
		"Info": "Attachment Uploaded Successfully"
	}
	]
	"ErrorRecords": null
}