Skip to main content
Version: 1.7.3

Delete

Deletes Form 1099-R return created in TaxBandits. Transmitted forms cannot be deleted.

If you need to delete the Transmitted or Accepted status records in Sandbox, you can contact our developer@taxbandits.com.

DELETE Form1099R/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]An unique identifier generated by TaxBandits when a 1099-R return is created. Mention the 1099-R 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-R records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099-R 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-R 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


Delete an existing form 1099-R return for the given SubmissionId and RecordId.

"Form1099R/Delete?SubmissionId=524af29a-a859-46a0-9223-110e02ec4660&RecordIds=55f703fc-4456-4ca6-ab5a-004cf714a95f"

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": "524af29a-a859-46a0-9223-110e02ec4660",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "55f703fc-4456-4ca6-ab5a-004cf714a95f",
"Status": "DELETED",
"StatusTs": "2021-11-24 08:30:09 -05:00",
"StateReturns": null
}
],
"ErrorRecords": null
},
"Errors": null
}