Skip to main content
Version: 1.7.3

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 
Run in Postman

Request Params

FieldTypeDescription
BusinessIdGuidUnique identifier of a business.
PayerRefstringUnique identifier of a business. Set by the client.
RecipientIdGuidAn 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.
PayeeRefstringUnique identifier of a recipient. Set by the client.
TaxYearstringTax year of Form 1099 to be filed.
Allowed values: "2021", "2022"
TxnFromDatestringList 1099 Transactions records created from
TxnToDatestringList 1099 Transactions records created up to
PagenumberPulls the records listed in the page selected.
PageSizenumberNumber 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=2022&TxnFromDate=01/01/2022&TxnToDate=12/31/2022&Page=1&PageSize=100"

Response Body

FieldTypeDescription
Form1099Txnsobject[]Transaction Details.
    BusinessobjectPayer Information.
        PayerRefstringUnique identifier of the payer. Set by the client.
        BusinessIdGuidTaxBandits Unique Business Identifier.
        TINTypestringTIN Type of the business.
Allowed values: "SSN", "EIN"
        TINstringTaxpayer Identification Number.
Size Range: 9-11
    Recipientsobject[]Recipient Information.
        PayeeRefstringUnique identifier of the recipient. Set by the client.
        RecipientIdGuidUnique identifier of the recipient.
        TotalPaymentAmtstringTotal Transaction Amount.
        TotalWHAmtstringOptional Total Amount withheld.
    PagenumberRequested Page Number.
    TotalRecordsnumberTotal number of records returned in the response.
    TotalPagesnumberTotal pages available for the business.
    PageSizenumberRequested Page Size.
Errorsobject[]Shows detailed error information
    IdstringReturns the validation error Id
    NamestringName of the validation error
    MessagestringDescription of the validation error

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
}