Skip to main content
Version: 1.7.0

Delete

You can delete the existing Form 1099-B returns created in TaxBandits. To delete an existing return, refer to it using unique identifiers such as SubmissionId, RecordId, and so on. A Transmitted return cannot be deleted. If you only provide the SubmissionId, all of the results that match that ID will be deleted.

DELETE Form1099B/Delete 
Run in Postman

Request Params

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

Request Params

"Form1099B/Delete?SubmissionId=3352a6aa-e22a-4d9b-bfed-8dc6e80d3d7d&RecordIds=203b32af-6a5d-4faa-91f9-adad5753fa5f"

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-B records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099-B 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-B 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

Response JSON

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "3352a6aa-e22a-4d9b-bfed-8dc6e80d3d7d",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "2",
"RecordId": "203b32af-6a5d-4faa-91f9-adad5753fa5f",
"Status": "DELETED",
"StatusTs": "2022-05-10 09:29:59 -04:00",
"StateReturns": null,
"OnlineAccess": null
}
],
"ErrorRecords": null
},
"Errors": null
}