Skip to main content
Version: 1.7.3

Delete

You can delete the existing Form 941 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.

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

The IRS has removed the COVID-related fields in Form 941 for tax year 2024. To refer to the documentation of Form 941 for tax year 2023,click here.

DELETE Form941/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]List of record Ids to be deleted.

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
Form941RecordsobjectPulls the Form 941 records with Success and Error statuses.
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 941 Records.
        SequenceIdstringA unique number given by an inbound application to identify failed records.
        RecordIdGuidUnique identifier of a record.
        RecordStatusstringReturns the status of the records.
        CreatedTsstringDate and time of return created.
        UpdatedTsstringDate and time of return updated.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 941 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

SampleDescriptionAction
Sample 1
Delete an existing form 941 return for the given SubmissionId and RecordId.
Sample 1
"Form941/Delete?SubmissionId=f90d587d-5852-4131-ad51-bb51977b7070&RecordIds=05427a1e-3fea-456f-b2e9-807fea20e09c"

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",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "05327a1e-3fea-456f-b2e9-807fea20e09c",
"RecordStatus": "DELETED",
"CreatedTs": "2024-03-04 23:58:08 -05:00",
"UpdatedTs": "2024-03-05 00:20:11 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}