Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

Get

This endpoint gets a particular submission and lists transactions for a particular payer or payer/recipient combination

  • To Get a particular submission supply the submissionid alone in the request.
  • To List the transactions of a particular payer or payer/recipient combination supply the parameters other than SubmissionId.
GET Form1099Transactions

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
BusinessIdGuidUnique identifier of a business.
PayerRefStringUnique identifier of a business. Set by the client.
RecipientIdGuidUnique identifier of a recipient.
PayeeRefStringUnique identifier of a recipient. Set by the client.
TaxYearStringTaxyear for which you want the transactions to be listed. In the format yyyy.
PageIntPage number that needs to be listed in the Response. If the value is not given, then the page will be defaulted to 1.
FromDateStringLists the transaction records between the date range.
ToDateStringLists the transaction records between the date range.

Response Body

FieldTypeDescription
Form1099TxnDetailsObject[]Transaction Details.
SubmissionIdGuidUnique identifier of a submission.
    TxnDataobject[]Collection of all the transactions from payers to recipients.
        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.
            TINTypeStringTIN Type of the recipient.
Allowed values: "SSN", "EIN"
            TINStringTaxpayer Identification Number.
Size Range: 9-11
            Txnsobject[]Collection of Transactions.
            SequenceIDStringOptional The SequenceId will act as a unique identifier for the transaction. TaxBandits will throw an error when there is an API request with a SequenceId that was previously sent. The SequenceId is an optional node.
It can be used to eliminate any chance of duplicate transaction submission.
Size Range: ..50
                TxnDateStringDate of transaction.
                TxnAmtStringTransaction Amount.
                WHAmtStringOptional Amount withheld.
PageIntRequested Page Number.
TotalRecordsIntTotal number of records returned in the response.
TotalPagesIntTotal pages available for the business.
PageSizeIntRequested Page Size.
ErrorsobjectShows error information.

Request 1: To Get a particular submission

Form1099Transactions?SubmissionId=7f54c788-5673-4cc2-afc2-d5933b54bc37

Response 1

{  "Form1099TxnDetails": [    {      "SubmissionId": "7f54c788-5673-4cc2-afc2-d5933b54bc37",      "TxnData": [        {          "Business": {            "PayerRef": "Be8523",            "BusinessId": "50e6e084-6c22-47a4-8a4e-018fd34eab42",            "TINType": "EIN",            "TIN": "64-3857839"          },          "Recipients": [            {              "PayeeRef": "Pe123",              "RecipientId": "43931da4-ccec-4054-81b5-7ca7249f3891",              "TINType": "SSN",              "TIN": "764-74-3823",              "Txns": [                {                  "SequenceId": "1",                  "TxnDate": "09/04/2020",                  "TxnAmt": 178.25,                  "WHAmt": 49.92                },                {                  "SequenceId": "2",                  "TxnDate": "08/03/2020",                  "TxnAmt": 108.26,                  "WHAmt": 28.91                },                {                  "SequenceId": "3",                  "TxnDate": "02/03/2020",                  "TxnAmt": 138.26,                  "WHAmt": 35.44                }              ]            }          ]        }      ]    }  ],  "Page": 1,  "TotalRecords": 1,  "TotalPages": 1,  "PageSize": 100,  "Errors": null}

Request 2: To list transactions under a payer and tax year.

Form1099Transactions?BusinessId=7289099A-E20F-4271-AB29-06865CECCB03&TaxYear=2020&Page=1&PageSize=10&TxnFromDate=01/01/2020&TxnToDate=12/30/2020"

Response 2

{ "Form1099TxnDetails": [   {     "SubmissionId": "17E1EFA1-37B8-4ACE-89E9-877FE749B64E",     "TxnData": [       {         "Business": {           "PayerRef": "B001",           "BusinessId": "7289099A-E20F-4271-AB29-06865CECCB03",           "TINType": "EIN",           "TIN": "12-3123123"         },         "Recipients": [           {             "PayeeRef": "R001",             "RecipientId": "4191EA42-CBDF-411F-A515-AC48ADB63D78",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "06/18/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "03/07/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           },           {             "PayeeRef": null,             "RecipientId": "4789EA42-CBDF-411F-A515-AC48ADB63D78",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "08/23/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "06/19/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           }         ]       },       {         "Business": {           "PayerRef": "F223432423",           "BusinessId": "4579099A-E20F-4271-AB29-06865CECCB03",           "TINType": "EIN",           "TIN": "78-3123365"         },         "Recipients": [           {             "PayeeRef": "R0123",             "RecipientId": "6591EA42-CBDF-411F-A515-AC48ADB6FH26",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "427.6",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "03/19/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "07/01/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           }         ]       }     ]   },   {     "SubmissionId": "26E1EFA1-37B8-4ACE-89E9-877FE749B66G",     "TxnData": [       {         "Business": {           "PayerRef": null,           "BusinessId": "7289099A-E20F-4271-AB29-06865CECCB03",           "TINType": "EIN",           "TIN": "12-3123123"         },         "Recipients": [           {             "PayeeRef": null,             "RecipientId": "4191EA42-CBDF-411F-A515-AC48ADB63D78",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "06/18/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "03/07/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           },           {             "PayeeRef": "R002",             "RecipientId": "4789EA42-CBDF-411F-A515-AC48ADB63D78",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "08/23/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "06/19/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           }         ]       },       {         "Business": {           "PayerRef": "F223432423",           "BusinessId": "4579099A-E20F-4271-AB29-06865CECCB03",           "TINType": "EIN",           "TIN": "78-3123365"         },         "Recipients": [           {             "PayeeRef": null,             "RecipientId": "6591EA42-CBDF-411F-A515-AC48ADB6FH26",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "427.6",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "03/19/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "07/01/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           }         ]       }     ]   } ], "Page": 1, "TotalRecords": 2, "TotalPages": 1, "PageSize": 10, "Errors": null}

Request 3: To list transactions under a payer and recipient for a particular tax year.

Form1099Transactions?BusinessId=7289099A-E20F-4271-AB29-06865CECCB03&recipientId=4191EA42-CBDF-411F-A515-AC48ADB63D78&TaxYear=2021&Page=1&PageSize=10&TxnFromDate=01/01/2020&TxnToDate=12/30/2020

Response 3

{ "Form1099TxnDetails": [   {     "SubmissionId": "17E1EFA1-37B8-4ACE-89E9-877FE749B64E",     "TxnData": [       {         "Business": {           "PayerRef": "B001",           "BusinessId": "7289099A-E20F-4271-AB29-06865CECCB03",           "TINType": "EIN",           "TIN": "12-3123123"         },         "Recipients": [           {             "PayeeRef": "R001",             "RecipientId": "4191EA42-CBDF-411F-A515-AC48ADB63D78",             "Txns": [               {                 "SequenceId": null,                 "TxnDate": "12/11/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "06/18/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               },               {                 "SequenceId": null,                 "TxnDate": "03/07/2020",                 "TxnAmt": "358.25",                 "WHAmt": null               }             ]           },           ]           }          ]       }     ]   } ], "Page": 1, "TotalRecords": 2, "TotalPages": 1, "PageSize": 10, "Errors": null}