Skip to main content
Version: 1.7.3

Get

Get

This method will return the completed 1099 MISC transactions of a particular submission or Payer.

The response will have the information such as the Transaction details, PayerRef, Recipient Information, etc.

Key Points:​

  • If you want to get the details of a particular Submission, provide the SubmissionId in the Get method. Response will provide the entire transaction based on the particular submission.
  • Provide parameters other than SubmissionId to get a list of transactions for a specific Payer or Payer/Recipient combination.
GET Form1099MiscTransactions
Run in Postman

Request Params

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.
TxnFromDateStringLists the transaction records between the date range.
TxnToDateStringLists 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. In the format mm/dd/yyyy or mm-dd-yyyy. Transaction date should be given in EST.
            TxnAmtStringTransaction Amount.
            WHAmtStringOptional Amount withheld.
            TypeOfPymtStringType of payment.
Allowed values

"BOX1", "BOX2", "BOX3", "BOX5", "BOX6", "BOX8", "BOX9", "BOX10", "BOX11", "BOX12", "BOX13", "BOX14", "BOX15"

            IsDirectSalesBooleanPayer made direct sales of $5,000 or more of consumer products to a buyer (recipient) for resale - When true, identifies the payer who made $5,000 or more of selling consumer products to a person on a buy-sell, deposit-commission, or other commission basis for resale (by the buyer or any other person) anywhere other than in a permanent retail establishment.
PageIntRequested Page Number.
TotalRecordsIntTotal number of records returned in the response.
TotalPagesIntTotal pages available for the business.
PageSizeIntRequested Page Size.
ErrorsobjectShows error information.

Request Params​

Form1099MISCTransactions?SubmissionId=0a7885ad-b828-4fb6-b3e8-1f418c8ef809&BusinessId=0bbc8702-1853-4320-94f0-4c04209c8309

Response JSON​

{
  "Form1099TxnDetails": [
      {
          "SubmissionId": "0a7885ad-b828-4fb6-b3e8-1f418c8ef809",
          "TxnData": [
              {
                  "Business": {
                      "PayerRef": "3344",
                      "BusinessId": "0bbc8702-1853-4320-94f0-4c04209c8309",
                      "TINType": "EIN",
                      "TIN": "XX-XXX1200",
                      "DBARef": null,
                      "DBAId": null
                  },
                  "Recipients": [
                      {
                          "PayeeRef": "23455667",
                          "RecipientId": "5d4f4945-dc84-420d-aa50-68fae4aac69a",
                          "TINType": "SSN",
                          "TIN": "XXX-XX-6536",
                          "Txns": [
                              {
                                  "SequenceId": "01",
                                  "TxnDate": "01/03/2025",
                                  "TxnAmt": "100.11",
                                  "WHAmt": "20.11",
                                  "TypeOfPymt": "BOX1",
                                  "IsDirectSales": false
                              },
                              {
                                  "SequenceId": "02",
                                  "TxnDate": "02/06/2025",
                                  "TxnAmt": "345000",
                                  "WHAmt": "20.11",
                                  "TypeOfPymt": "BOX2",
                                  "IsDirectSales": false
                              },
                              {
                                  "SequenceId": "03",
                                  "TxnDate": "03/12/2025",
                                  "TxnAmt": "2000.87",
                                  "TypeOfPymt": "BOX3",
                                  "IsDirectSales": false
                              }
                          ]
                      }
                  ]
              }
          ]
      }
  ],
  "Page": 1,
  "TotalRecords": 1,
  "TotalPages": 1,
  "PageSize": 100,
  "Errors": null
}