Skip to main content
Version: 1.7.3

Validate

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

The IRS has removed the COVID-related fields in Form 943 for tax year 2024. To refer to the documentation of Form 943 for tax year 2023,click here.

GET Form943/Validate 
Run in Postman

Request Params

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

Request Params

"Form943/validate?SubmissionId=8bc5fb5e-f89c-4a3a-aa82-793c9ec3c932&RecordId=3a3f7dfd-5191-439c-a347-956d2a41a54e"

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": "8bc5fb5e-f89c-4a3a-aa82-793c9ec3c932",
"Form943Records": {
"SuccessRecords": [
{
"SequenceId": "4",
"RecordId": "3a3f7dfd-5191-439c-a347-956d2a41a54e",
"RecordStatus": "Created",
"CreatedTs": "2025-01-15 07:20:21 -05:00",
"UpdatedTs": "2025-01-15 07:27:14 -05:00",
"Errors": null
}
],
"ErrorRecords": null
},
"Errors": null
}