Skip to main content
Version: 1.7.3

Post

Post

The 1099-MISC transaction flow supports reporting miscellaneous income such as rent, royalties, prizes, awards, or other types of income not covered under nonemployee compensation.

Use this API to transmit payout details for such transactions. All records are maintained by TaxBandits and can be used to generate and file Form 1099-MISC for recipients who qualify at the end of the tax year.

Here’s how Form 1099Transactions endpoint may be used:​

  1. Call the Auth method to get the access token. This access token must be supplied in the request header as the ‘Bearer‘ token. Refer OAuth authentication API for more information on JWT authentication and how to integrate with the subsequent requests.
  2. The second step is to call the Form1099MISCTransactions Post method [POST Form1099MISCTransactions] with the following values.
  • Business - Specify the payer from whom the Transactions were made. 

Any one of the following unique identifiers of the business (Payer) is mandatory.​

  • Payer Reference - This identifier is specified by the client while using the endpoint Business/RequestByUrl.
  • BusinessId - This ID is generated by Taxbandits and returned in the response of Business/Create and Business/RequestByUrl endpoints. Refer to the Business endpoint to learn more about creating a Business in TaxBandits and retrieving the Business Id.
  • TIN - Use Business TIN as an alternate identifier if you have not saved the Payer Reference
    or BusinessId.
  • Recipients - Specify the recipients to whom the Transactions were made. Any one of the following unique identifiers of the recipient is mandatory.
    • PayeeRef - This identifier is specified by the client while using the endpoint FormW9/RequestByUrl. Refer Form W-9 endpoint to know more about Form W-9 in TaxBandits API.
    • RecipientId - This ID is generated by Taxbandits and returned in the webhook responses of Form W-9 and TIN Matching endpoints. The RecipientId is also returned in the 1099 (MISC, NEC) create response.
    • TIN - Use Business TIN as an alternate identifier if you have not saved the PayeeRef or RecipientId.
  • Transactions (Txns) - Transactions made by the payer to recipient.
    • SequenceID - It is the unique identifier for each transactions.
    • TxnDate - Date in which the transaction is made. This should be given in EST.
    • TxnAmt - Transaction amount in dollars. Enter the full compensation(Including the withholding amount) that has to be paid to the recipient/affiliate.
    • WHAmt - Amount withheld from the compensation paid to the recipient/affiliate.
    • TypeOfPymt- Type of payment made to the recipient
    • IsDirectSales- 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.

Key Factors:​

  • A single submission can include transactions from numerous payers to multiple recipients.
  • Transactions that have already been posted cannot be changed. Instead, use the Delete endpoint to remove an old submission and replace it with a new one.
POST Form1099MiscTransactions
Run in Postman

Request Body

FieldTypeDescription
TxnDataobject[]This Object contains the Payer, Recipient and Transaction details.
    BusinessobjectPayer Information. Either PayerRef, BusinessId or TIN is mandatory.
        PayerRefStringUnique identifier of the payer. Set by the client in the endpoint Business/RequestByUrl.
        BusinessIdGuidTaxBandits Unique Business Identifier. This ID is generated by TaxBandits after you create a business in your account using the Business endpoint.
        TINTypeStringTIN Type of the business.
Allowed values: "SSN", "EIN"
        TINStringTaxpayer Identification Number. Use this as an alternative for BusinessId or PayerRef.
Size Range: 9-11
    Recipientsobject[]Recipient Information. Either PayeeRef, RecipientId or TIN is mandatory.
        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. Use this as an alternative for RecipientId or PayeeRef.
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.

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
StatusMsgStringStatus Message.
StatusTsStringTime Stamp of the status.
ErrorsobjectShows error information. This object will list the errors in the request parameters.

Request JSON​

{
  "SubmissionId": null,
  "TxnData": [
      {
          "Business": {
              "PayerRef": null,
              "BusinessId": "0bbc8702-1853-4320-94f0-4c04209c8309",
              "TINType": null,
              "TIN": null,
              "DBARef": null,
              "DBAId": null
          },
          "Recipients": [
              {
                  "PayeeRef": null,
                  "RecipientId": "5d4f4945-dc84-420d-aa50-68fae4aac69a",
                  "TINType": null,
                  "TIN": null,
                  "Txns": [
                      {
                          "SequenceId": "01",
                          "TxnDate": "01/03/2025",
                          "TxnAmt": "1200.34",
                          "WHAmt": "20.11",
                          "TypeOfPymt": "BOX1",
                          "IsDirectSales": false
                      },
                      {
                          "SequenceId": "02",
                          "TxnDate": "02/06/2025",
                          "TxnAmt": "3000.11",
                          "WHAmt": "20.11",
                          "TypeOfPymt": "BOX2",
                          "IsDirectSales": false
                      },
                      {
                          "SequenceId": "03",
                          "TxnDate": "03/12/2025",
                          "TxnAmt": "1000",
                          "WHAmt": "20.11",
                          "TypeOfPymt": "BOX3",
                          "IsDirectSales": false
                      }
                     
                  ]
              }
          ]
      }
  ]
}

Response JSON​

{
    "SubmissionId": "0a7885ad-b828-4fb6-b3e8-1f418c8ef809",
    "StatusMsg": "Transactions saved successfully",
    "StatusTs": "2025-10-31 01:57:34 -04:00",
    "Errors": null
}