Skip to main content
Version: 1.7.3

Delete

Deletes Form 1042-S 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  Form1042S/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidMention the 1042-S returns Submission ID that you want to delete.
RecordIdsGuid[]Mention the 1042-S returns Record ID that you want to delete. Multiple RecordIds under the same Submission can be deleted by sending the RecordIds comma separated.

Request Params

"Form1042S/Delete?SubmissionId=462a5651-1b92-4093-8eb2-8845dcc7929e&RecordIds=27227762-0981-4f3b-b115-1aed8671e478"

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

Success Response - This is a sample response for successful API requests.

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "462a5651-1b93-4093-8eb2-8845dcc7929e",
"Form1042SRecords": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "27227762-0981-4f3b-b115-1aed8671e478",
"Status": "DELETED",
"StatusTs": "2024-06-21 02:04:44 -04:00",
"OnlineAccess": null,
"Postal": null
}
],
"ErrorRecords": null
},
"Info": null,
"Errors": null
}