Report

Report

Use this endpoint to retrieve a summary report of recorded 1099 transactions.

This endpoint is applicable only if you are recording 1099 transactions in the TaxBandits API and later generating 1099 forms using the stored transaction data.

The report provides a consolidated view of recipients and their total transactions, including any withholding amounts, for a specified time range.

How It Works

1. OAuth Authentication Call the Auth method to obtain an access token. This token must be included in the request header as a Bearer token for all subsequent API requests. Refer to OAuth authentication for more information.

2. Call the GET Reports/Form1099Transactions Endpoint After authentication, call the GET Reports/Form1099Transactions endpoint with the required parameters to retrieve the transaction report for the specified date range.

GET Reports/Form1099Transactions 

Run in Postman

Request Params

Field	Type	Description
BusinessId	Guid	Unique identifier of a business.
PayerRef	string	Unique identifier of a business. Set by the client.
RecipientId	Guid	An unique ID generated by TaxBandits after the return is created and will be returned in the Response. You can us this id for your future reference to Update.
PayeeRef	string	Unique identifier of a recipient. Set by the client.
TaxYear	string	Tax year of Form 1099 to be filed. Allowed values "2024", "2025"
TxnFromDate	string	List 1099 Transactions records created from
TxnToDate	string	List 1099 Transactions records created up to
Page	number	Pulls the records listed in the page selected.
PageSize	number	Number of 1099 Transactions records to be listed in each page.

Response Body

Field	Type	Description
Form1099Txns	object[]	Transaction Details.
Business	object	Payer Information.
PayerRef	string	Unique identifier of the payer. Set by the client.
BusinessId	Guid	TaxBandits Unique Business Identifier.
TINType	string	TIN Type of the business. Allowed values "SSN", "EIN"
TIN	string	Taxpayer Identification Number. Size Range: 9-11
Recipients	object[]	Recipient Information.
PayeeRef	string	Unique identifier of the recipient. Set by the client.
RecipientId	Guid	Unique identifier of the recipient.
TotalPaymentAmt	string	Total Transaction Amount.
PaymentType	string	Type of Payment.
TotalWHAmt	string	Optional Total Amount withheld.
Page	number	Requested Page Number.
TotalRecords	number	Total number of records returned in the response.
TotalPages	number	Total pages available for the business.
PageSize	number	Requested Page Size.
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error Id
Name	string	Name of the validation error
Message	string	Description of the validation error

Request Params

"Reports/Form1099Transactions?BusinessId=dc81b66c-4ec6-4c88-a2f6-92a079e16d0f&Payerref=1763_tax&RecipientId=2030b288-dc6a-4ef3-a967-6cf001400b4b&PayeeRef=1743_37568&TaxYear=2025&TxnFromDate=01/01/2025&TxnToDate=12/31/2025&Page=1&PageSize=100"

Response JSON

{
   "Form1099Txns": {
       "Business": {
           "PayerRef": "1763_tax",
           "BusinessId": "dc81b66c-4ec6-4c88-a2f6-92a079e16d0f",
           "TINType": "EIN",
           "TIN": "469103421"
       },
       "Recipients": [
           {
               "PayeeRef": "1743_37568",
               "RecipientId": "2030b288-dc6a-4ef3-a967-6cf001400b4b",
               "TotalPaymentAmt": 43621.04,
               "TotalWHAmt": 4147.83
           }
       ],
       "Page": 1,
       "TotalRecords": 1,
       "TotalPages": 1,
       "PageSize": 100
   },
   "Errors": null
}