Skip to main content
Version: 1.7.3

Validate

Use this method to validate the 941-X forms that are already created in TaxBandits with the IRS business. This can help you prevent certain common errors before transmission.

GET Form941X/Validate 
Run in Postman

Request Params

FieldTypeDescription
SubmissionIdstringUnique identifier of a submission.
RecordIdsstringOptional List of Record IDs for Validation.

Request Params

"Form941X/Validate?SubmissionId=7c1f1df2-61f1-4881-88d5-2a5db230e987&RecordIds=9ae8badc-d68e-4913-a050-fae80d0a9acd"

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.
Form941XRecordsobjectPulls the Form 941-X records with Success and Error statuses.
SuccessRecordsobject[]It will show the detailed information about the success status of Form 941-X Records.
    SequenceIdstringA 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-X Records.
    RecordIdGuidUnique identifier of a record.
    SequenceIdstringA unique number given by an inbound application to identify failed records.
    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.

Response JSON

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

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