Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.0

Status

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

GET Form943/Status

Request Parameters

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

Response Parameters

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.

Request JSON

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

Response JSON

{
"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
}