Skip to main content
Version: 1.7.3

Delete

Deletes 941SCHR returns by Submission Ids and Record Ids.

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 Sch R for tax year 2024. To refer to the documentation of Form 941 Sch R for tax year 2023,click here.

DELETE Form941SCHR/Delete 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsstringList of record Ids to be deleted.

Request Params

"Form941SCHR/delete?SubmissionId=54c7ea74-b3e8-4f99-98a1-1311611b410c&RecordIds=a5f5ed51-1723-4316-b0f0-c84d0d53e2d8"

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
Form941SchRRecordsobjectPulls the Form 941SCHR records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 941 Schedule R 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.
        ClientSuccessRecordsobject[]Client Success Status
            CSeqIdstringThis identifies the sequence on the record sent in the payload. When errors occur we will send the errors attached to particular sequence. Required
            CRecordIdGuidClient Record Identifier
            RecordStatusstringReturn status details like Processing, Created, Accepted, Rejected.
            CreatedTsstringReturn created date and time
            UpdatedTsstringReturn updated date and time
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 941 Schedule 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.
        ClientErrorRecordsobject[]Client Error Status
            CSeqIdstringThis identifies the sequence on the record sent in the payload. When errors occur we will send the errors attached to particular sequence. Required
            CRecordIdGuidClient Record Identifier
            Errorsobject[]It will show the detailed information about the error.
                IdstringIt will return the validation error code.
                NamestringIt will return the name of the validation error.
                MessagestringIt will return the detailed message 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",
"Form941SchRecords": {
"SuccessRecords": [
{
"SequenceId": null,
"RecordId": "a5f5ed51-1723-4316-b0f0-c84d0d53e2d8",
"RecordStatus": "DELETED",
"CreatedTs": "2024-03-05 00:01:42 -05:00",
"UpdatedTs": "2024-03-05 00:18:27 -05:00",
"ClientSuccessRecords": null
}
],
"ErrorRecords": null
},
"Errors": null
}