Report
-
If you are using TaxBandits API to send Transactions and then generate 1099s using the data, this endpoint will be applicable to you.
-
This endpoint will list the recipients and their total transactions along with the withheld information for a particular time range.
GET Reports/Form1099Transactions
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: "2021", "2022" |
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. |
Request Params
"Reports/Form1099Transactions?BusinessId=dc81b66c-4ec6-4c88-a2f6-92a079e16d0f&Payerref=1763_tax&RecipientId=2030b288-dc6a-4ef3-a967-6cf001400b4b&PayeeRef=1743_37568&TaxYear=2021&TxnFromDate=01/01/2021&TxnToDate=12/31/2021&Page=1&PageSize=100"
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. |
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 |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"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
}