Status
Gets the status of the 944 returns by Submission Id and Record Ids.
Federal Return Statuses:
- Created: Form 944 has been created and not yet transmitted by the user.
- Transmitted: Form 944 has been transmitted by the user.
- Accepted: Form 944 is accepted by the IRS.
- Rejected: Form 944 is rejected by the IRS due to some errors. Please correct the errors and retransmit them.
GET Form944/Status
Request Params
Field | Type | Description |
---|---|---|
SubmissionId | Guid | Unique identifier of a submission |
Request Params
"Form944/status?SubmissionId=71454e6b-fb3e-487a-9582-688214f03fb8"
Response Body
Field | Type | Description |
---|---|---|
StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
StatusName | string | Name of the status code. |
StatusMessage | string | Detailed status message. |
SubmissionId | Guid | Unique identifier of a submission. |
Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
SequenceId | string | A unique number given by an inbound application to identify failed records. |
RecordId | Guid | Unique identifier of a record. |
RecordStatus | string | Returns the status of the records. |
CreatedTs | string | Date and time of return created. |
UpdatedTs | string | Date and time of return updated. |
ErrorRecords | object[] | It will show the detailed information about the error status of Form 941 Records. |
RecordId | Guid | Unique identifier of a record. |
SequenceId | string | A unique number given by an inbound application to identify failed records. |
Errors | object[] | Shows detailed error information. |
Id | string | Returns the validation error id. |
Name | string | Name of the validation error. |
Message | string | Description of the validation error. |
Errors | object[] | Shows detailed error information. |
Id | string | Returns the validation error code. |
Name | string | Name of the validation error. |
Message | string | Description 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": "71454e6b-fb3e-487a-9582-688214f03fb8",
"Form944Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "ed5279fc-7325-4438-80c2-20388b39d842",
"RecordStatus": "Transmitted",
"CreatedTs": "2023-10-03 03:39:06 -04:00",
"UpdatedTs": "2023-10-03 03:39:49 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}