Skip to main content
Version: 1.7.0

Status

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

Federal Return Statuses:

  • Created: Form 943 has been created and not yet transmitted by the user.
  • Transmitted: Form 943 has been transmitted by the user.
  • Accepted: Form 943 is accepted by the IRS.
  • Rejected: Form 943 is rejected by the IRS due to some errors. Please correct the errors and retransmit them.
GET Form943/Status 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdstringUnique identifier of a submission
RecordIdsstringOptional Gets the status for a list of Record IDs
ReturnTypestringOptional Type of the return to be filed. Enter value as FORM943
EINstringOptional Employer Identification Number
TaxYearstringOptional Tax year for which Form 943 needs to be filed

Request Params

"Form943/Status?SubmissionId=7f9cb1ab-f90b-4358-ae5f-acfe19617d96&RecordIds=22af7b4b-42f2-4e68-a9ac-743d2fd76636&ReturnType=FORM943&EIN=005498751&TaxYear=2019"

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.
Form943RecordsobjectPulls the Form 943 records with Success and Error statuses.
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 943 Records.
        SequencestringA 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 943 Records
        RecordIdGuidUnique identifier of a record.
        SequencestringA unique number given by an inbound application to identify failed records.
        Errorsobject[]Shows detailed error information.
            CodestringReturns the validation error code.
            NamestringName of the validation error.
            MessagestringDescription of the validation error.
            TypestringType of validation error.
Errorsobject[]Shows detailed error information.
    CodestringReturns the validation error code.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.
    TypestringType of validation error.

Response JSON

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

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "7f9cb1ab-f90b-4358-ae5f-acfe19617d96",
"Form943Records": {
"SuccessRecords": [
{
"Sequence": null,
"RecordId": "22af7b4b-42f2-4e68-a9ac-743d2fd76636",
"RecordStatus": "Created",
"CreatedTs": "2020-02-02 01:29:56 -04:00",
"UpdatedTs": "2020-02-02 01:29:56 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}