Skip to main content
Version: 1.7.3

Status

Status

Gets the status of the 941SCHR returns by Submission Id and Record Ids.

Federal Return Statuses:

  • Created: Form 941 SCHR has been created and not yet transmitted by the user.
  • Transmitted: Form 941 SCHR has been transmitted by the user.
  • Accepted: Form 941 SCHR is accepted by the IRS.
  • Rejected: Form 941 SCHR is rejected by the IRS due to some errors. Please correct the errors and retransmit them.

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

GET Form941SCHR/Status 

Request Params

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
RecordIdsstringList of record Ids to get status.

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.
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.
        PayerRefstringUnique identifier of the payer.
        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 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 id.
            NamestringName of the validation error.
            MessagestringDescription of the validation error.
Errorsobject[]Shows detailed error information.
    IdstringReturns the validation error id.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.

Request Params

"Form941SCHR/status?SubmissionId=fc960bb7-f14f-45f2-9e0e-dc9f5d9f23d0&RecordIds=9bee2e04-ecb4-4d2b-864a-fd98f477e871"
Response JSON

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

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "fc960bb7-f14f-45f2-9e0e-dc9f5d9f23d0",
"Form941SchRRecords": {
"SuccessRecords": [
{
"SequenceId": null,
"BusinessId": "efd21ef1-868a-4a35-877f-e2904aaf1515",
"PayerRef": "Snow1234",
"RecordId": "9bee2e04-ecb4-4d2b-864a-fd98f477e871",
"RecordStatus": "Created",
"UpdatedTs": "2026-03-21 08:07:51 -04:00",
"CreatedTs": "2026-03-21 08:07:51 -04:00",
"Errors": null
}
],
"ErrorRecords": null
},
"Errors": null
}