Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

Validate

Runs business and data validation checks for the 941 forms already created in API. You must use the Submission ID of the return to Validate.

GET Form941/Validate

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]Unique identifier of a record

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.
Form941RecordsobjectPulls the Form 941 records with Success and Error statuses.
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 941 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 941 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

Form941/validate?SubmissionId=8847cee7-2275-4493-a5c3-c06ed1de530c&RecordIds=f93602df-ceaf-48a4-a3cf-431bb6b6ddba

Response JSON

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
"Form941Records": {
"SuccessRecords": [
{
"Sequence": "",
"RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
"RecordStatus": "Created",
"CreatedTs": "2019-08-06 03:06:07 -04:00",
"UpdatedTs": "2019-08-06 03:46:54 -04:00"
}
],
"ErrorRecords": []
},
"Errors": null
}