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
Request Params
Field | Type | Description |
---|---|---|
SubmissionId | string | Unique identifier of a submission. |
RecordIds | string | Optional List of Record IDs for Validation. |
Request Params
"Form941X/Validate?SubmissionId=7c1f1df2-61f1-4881-88d5-2a5db230e987&RecordIds=9ae8badc-d68e-4913-a050-fae80d0a9acd"
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. |
Form941XRecords | object | Pulls the Form 941-X records with Success and Error statuses. |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 941-X 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-X 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 id. |
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": "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
}