Get

Get

Use this method to retrieve 1099 transaction details for a specific submission or payer that were previously recorded in TaxBandits.

The response includes transaction information such as the payer reference, recipient details, transaction amounts, payment type, and other related transaction data.

Key Points:

• Provide the SubmissionId to retrieve all transaction details associated with a specific submission.
• If SubmissionId is not provided, you can use other parameters to retrieve transactions for a specific payer or payer and recipient combination.
• The response will include details such as transaction information, payer reference, recipient details, and related submission data.

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 Form1099Transactions Endpoint After authentication, call the GET Form1099Transactions endpoint to retrieve the required transaction information.

GET Form1099Transactions 

Run in Postman

Request Params

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	Unique identifier of a business.
PayerRef	String	Unique identifier of a business. Set by the client.
RecipientId	Guid	Unique identifier of a recipient.
PayeeRef	String	Unique identifier of a recipient. Set by the client.
TaxYear	String	Taxyear for which you want the transactions to be listed. In the format yyyy.
Page	Int	Page number that needs to be listed in the Response. If the value is not given, then the page will be defaulted to 1.
TxnFromDate	String	Lists the transaction records between the date range.
TxnToDate	String	Lists the transaction records between the date range.

Response Body

Field	Type	Description
Form1099TxnDetails	Object[]	Transaction Details.
SubmissionId	Guid	Unique identifier of a submission.
TxnData	object[]	Collection of all the transactions from payers to recipients.
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.
TINType	String	TIN Type of the recipient. Allowed values: "SSN", "EIN"
TIN	String	Taxpayer Identification Number. Size Range: 9-11
Txns	object[]	Collection of Transactions.
SequenceID	String	Optional 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
TxnDate	String	Date of transaction.
TxnAmt	String	Transaction Amount.
PaymentType	String	Type of payment.
WHAmt	String	Optional Amount withheld.
Page	Int	Requested Page Number.
TotalRecords	Int	Total number of records returned in the response.
TotalPages	Int	Total pages available for the business.
PageSize	Int	Requested Page Size.
Errors	object	Shows error information.

Request Params

Sample 1

Get the details of a particular submission using SubmissionId

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

Sample 2

To list all the available transactions under a specific payer and tax year.

Form1099Transactions?SubmissionId=7f54c788-5673-4cc2-afc2-d5933b54bc37&TaxYear=2025&Page=1&PageSize=10&TxnFromDate=01/01/2025&TxnToDate=12/30/2025

Response JSON

Response 1

The response will include all relevant information for the given SubmissionId.

{
"Form1099TxnDetails": [
  {
    "SubmissionId": "cef9c3c0-1451-419b-83e5-f000bb9ece8c",
     "TxnData": [
      {
        "Business": {
          "PayerRef": "337 d2B8",
          "BusinessId": "daf6673b-5a44-4c83-a131-30f285730a63",
          "TINType": "EIN",
          "TIN": "XX-XXX3059",
          "DBARef": null,
          "DBAId": null
        },
        "Recipients": [
          {
            "PayeeRef": "Pe6993cap01",
            "RecipientId": "2992e29a-975e-4d72-afc6-86a6028ccb2a",
            "TINType": "SSN",
            "TIN": "XXX-XX-5345",
            "Txns": [
              {
                "SequenceId": "01",
                "TxnDate": "03/01/2025",
                "TxnAmt": 178.25,
                "WHAmt": 49.92,
                "PaymentType": "NEC"
              },
              {
                "SequenceId": "02",
                "TxnDate": "02/26/2025",
                "TxnAmt": 1000.25,
                "WHAmt": 200,
                "PaymentType": "RENT"
              },
              {
                "SequenceId": "03",
                "TxnDate": "01/01/2025",
                "TxnAmt": 22500,
                "WHAmt": 50,
                "PaymentType": "ROYALTY"
              },
              {
                "SequenceId": "04",
                "TxnDate": "12/12/2025",
                "TxnAmt": 45,
                "WHAmt": 20,
                "PaymentType": "OTHERINCOME"
              },
              {
                "SequenceId": "05",
                "TxnDate": "12/01/2026",
                "TxnAmt": 45,
                "WHAmt": 0.89,
                "PaymentType": "OTHERINCOME"
              }
            ]
          }
        ]
      }
    ]
  },
  {
    "SubmissionId": "0d60dc9d-e0a2-4432-89fb-72a5591b884a",
    "TxnData": [
      {
        "Business": {
          "PayerRef": "337 d2B8",
          "BusinessId": "daf6673b-5a44-4c83-a131-30f285730a63",
          "TINType": "EIN",
          "TIN": "XX-XXX3059",
          "DBARef": null,
          "DBAId": null
},
        "Recipients": [
          {
            "PayeeRef": "Pe6993",
            "RecipientId": "a7300067-b20a-41d5-a5ed-04bc9f7fe768",
            "TINType": "EIN",
            "TIN": "XX-XXX6346",
            "Txns": [
              {
                "SequenceId": "1",
                "TxnDate": "01/01/2025",
                "TxnAmt": 178.25,
                "WHAmt": 49.92,
                "PaymentType": "NEC"
              },
              {
                "SequenceId": "2",
                "TxnDate": "01/01/2025",
                "TxnAmt": 1000.25,
                "WHAmt": 200,
                "PaymentType": "RENT"
              },
              {
                "SequenceId": "3",
                "TxnDate": "01/01/2025",
                "TxnAmt": 22500,
                "WHAmt": 50,
                "PaymentType": "ROYALTY"
              },
              {
                "SequenceId": "4",
                "TxnDate": "01/01/2025",
                "TxnAmt": 45,
                "WHAmt": 0,
                "PaymentType": "OTHERINCOME"
              },
              {
                "SequenceId": "5",
                "TxnDate": "12/01/2026",
                "TxnAmt": 45,
                "WHAmt": 0,
                "PaymentType": "OTHERINCOME"
              }
            ]
          }
        ]
      }
    ]
  }
],
"Page": 1,
"TotalRecords": 2,
"TotalPages": 1,
"PageSize": 100,
"Errors": null
}

Response 2

It returns the transaction details based on the given specific Payer and tax year.

{
  "Form1099TxnDetails": [
      {
          "SubmissionId": "e5ca7490-f8b1-4f6e-9dbf-00243c0b07bb",
          "TxnData": [
              {
                  "Business": {
                  "PayerRef": "73635",
                      "BusinessId": "2da950ad-9bff-4f85-9864-ca47c09f7df7",
                      "TINType": "EIN",
                      "TIN": "XX-XXX2136",
                      "DBARef": null,
                      "DBAId": null
                  },
                  "Recipients": [
                      {
                          "PayeeRef": "84948888984",
                          "RecipientId": "831b3c49-80c8-41c4-9d9f-e817f3b520a3",
                          "TINType": "SSN",
                          "TIN": "XXX-XX-3286",
                          "Txns": [
                              {
                                  "SequenceId": "1",
                                  "TxnDate": "01/01/2025",
                                  "TxnAmt": 178.25,
                                  "WHAmt": 49.92,
                                  "PaymentType": "NEC"
                              },
                              {
                                  "SequenceId": "2",
                                  "TxnDate": "01/01/2025",
                                  "TxnAmt": 1000.25,
                                  "WHAmt": 200.00,
                                  "PaymentType": "RENT"
                              },
                              {
                                  "SequenceId": "3",
                                  "TxnDate": "01/05/2025",
                                  "TxnAmt": 22500.00,
                                  "WHAmt": 50.00,
                                  "PaymentType": "ROYALTY"
                              },
                              {
                                  "SequenceId": "4",
                                  "TxnDate": "05/10/2025",
                                  "TxnAmt": 45.00,
                                  "WHAmt": 0.00,
                                  "PaymentType": "OTHERINCOME"
                              },
                              {
                                  "SequenceId": "5",
                                  "TxnDate": "01/01/2024",
                                  "TxnAmt": 45.00,
                                  "WHAmt": 0.00,
                                  "PaymentType": "OTHERINCOME"
                              }
                          ]
                      }
                  ]
              }
          ]
      }
  ],
  "Page": 1,
  "TotalRecords": 1,
  "TotalPages": 1,
      "PageSize": 100,
      "Errors": null
  }