Delete

Delete

Use this method to remove previously submitted 1099 transaction records from TaxBandits. This endpoint allows you to delete either an entire transaction submission or specific transactions within a submission.

Key Points

• Provide the SubmissionId to delete all transactions associated with that submission.

• Provide both the SubmissionId and SequenceId to delete specific transactions within a submission.

• If only the SequenceId is provided, the corresponding transactions will be deleted across all submissions

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 DELETE Form1099Transactions Endpoint: After authentication, call the DELETE Form1099Transactions endpoint with the required identifiers to remove the corresponding transaction records.

DELETE Form1099Transactions 

Run in Postman

Request Params

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission. It is generated by TaxBandits. This Id can be retrieved in the response.
SequenceId	string	This is a unique identifier for a particular transaction when it is posted to your TaxBandits account.

Response Body

Field	Type	Description
SuccessRecords	object	It will show the detailed information about the success status of the transaction records.
SubmissionId	Guid	Unique identifier of a submission.
PayeeRef	string	Unique identifier of the recipient. Set by the client.
RecipientId	Guid	Unique identifier of the recipient.
Txns	object	Collection of Transactions.
SequenceID	string	Unique identifier for a particular transaction when it is posted to your TaxBandits account
Status	string	Status Message.
StatusTs	string	Time Stamp of the status.
ErrorRecords	object[]	It will show the detailed information about the error status of the Transaction Records.
SequenceId	string	Unique identifier for a particular transaction when it is posted to your TaxBandits account
RecordId	Guid	Unique identifier of a record
Errors	object	Shows error information. This object will list the errors in the request parameters.
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Errors	object	Shows error information. This object will list the errors in the request parameters.
Id	string	Returns the validation error Id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request Params

Sample 1

Delete the transaction by providing only a SubmissionId.

Form1099Transactions?SubmissionId=5a086e1f-72b2-433c-8f31-add986300cca

Sample 2

Delete the transaction by providing both the SubmissionId and SequenceId.

Form1099Transactions?SubmissionId=5a086e1f-72b2-433c-8f31-add986300cca&SequenceId=Payeeref1_2

Response JSON

Response 1

All the transactions corresponding to the given SubmissionId will be deleted.

{
  "SuccessRecords": [
      {
          "SubmissionId": "c2615081-d1b0-4936-9c33-124d03d9da42",
          "PayeeRef": "VSONEW",
          "RecipientId": "a13d4377-457a-4930-a65b-2be94df90a19",
          "Txns": [
              {
                  "SequenceId": "1",
                  "Status": "Deleted Successfully",
                  "StatusTs": "2026-03-06 03:10:46 -05:00"
              }
          ]
      },
      {
          "SubmissionId": "6f277949-04da-429e-96b8-370ad6db1a57",
          "PayeeRef": "Pe6993cap01",
          "RecipientId": "2992e29a-975e-4d72-afc6-86a6028ccb2a",
          "Txns": [
              {
                  "SequenceId": "1",
                  "Status": "Deleted Successfully",
                  "StatusTs": "2026-03-06 03:10:46 -05:00"
              }
          ]
      }
  ],
   "ErrorRecords": null,
  "Errors": null
}

Response 2

All the transactions corresponding to the given SequenceId will be deleted.

{
  "SuccessRecords": [
      {
          "SubmissionId": "e5ca7490-f8b1-4f6e-9dbf-00243c0b07bb",
          "PayeeRef": "84948888984",
          "RecipientId": "831b3c49-80c8-41c4-9d9f-e817f3b520a3",
          "Txns": [
              {
                  "SequenceId": "5",
                  "Status": "Deleted Successfully",
                  "StatusTs": "2026-03-06 03:43:46 -05:00"
              }
          ]
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}