Skip to main content
Version: 1.7.3

Delete

Delete

Use this endpoint to delete any in-progress 1099-INT returns created in TaxBandits. When deleting, provide unique identifiers such as SubmissionId, RecordId, etc. If only the SubmissionId is provided, all returns associated with that ID will be deleted.

Note: In the Live environment, returns with a Transmitted or Accepted status cannot be deleted. However, in the Sandbox environment, you can delete returns regardless of their status (Transmitted, Rejected, or Accepted).

DELETE  Form1099INT/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]An unique identifier generated by TaxBandits when a 1099-INT return is created. Mention the 1099-INT return's Record ID that you want to delete.

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code
StatusMessagestringDetailed status message
SubmissionIdGuidUnique identifier of a submission
Form1099RecordsobjectPulls the Form 1099-INT records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099-INT Records
        SequenceIdstringA unique number is given by an inbound application to identify failed records
        RecordIdGuidUnique identifier of a record
        StatusstringReturns the status of the records.
        StatusTsstringDate and time of return deleted.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 1099-INT Records.
        SequenceIdstringA unique number given by an inbound application to identify failed records
        RecordIdGuidUnique identifier of a record
        Errorsobject[]Shows detailed error information
            IdstringReturns the validation error code
            NamestringName of the validation error
            MessagestringDescription of the validation error
Errorsobject[]Shows detailed error information
    IdstringReturns the validation error code
    NamestringName of the validation error
    MessagestringDescription of the validation error
Request Params
Delete an existing form 1099-INT return for the given SubmissionId and RecordId.
"Form1099INT/Delete?SubmissionId=2db32e31-e641-466b-b9ad-fd935699e79d&RecordIds=c9c52747-0737-4fc2-b30e-16506ba067bc"
Response Json
ResponseDescriptionAction
200
Success Response - This is a sample response for successful API requests.
Response: 200
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "2db32e31-e641-466b-b9ad-fd935699e79d",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "c9c52747-0737-4fc2-b30e-16506ba067bc",
"Status": "DELETED",
"StatusTs": "2021-11-25 05:58:17 -05:00",
"StateReturns": null
}
],
"ErrorRecords": null
},
"Errors": null
}