​
Check Result

Example of a response payload for the /getJobsByCaseId endpoint:

{
    "jobs": [
        {
            "id": "539108a4-3a19-4ecf-88d0-a6468194cedc",
            ...
            "check_results": [
                /* list of check_result objects */
                {
                    /* general info */
                    "agent_key": "agent-kyb-v1",
                    "agent_instance_id": "9db890b9-2d9d-4e4f-a802-18ecef5d72b3",
                    "command_id": "kyb.incorporation_document_verification",
                    "command_name": "Incorporation Document Check",
                    "command_desc": "A tool to verify a business registration/formation documents provided by applicant and extracting relevant data",
                    "command_instance_id": "b3a753c2-500f-4043-93e4-802554635213",
                    "data_loader_id": null,
                    "job_id": "539108a4-3a19-4ecf-88d0-a6468194cedc",
                    "created_at": "2024-11-08T20:19:47.959210",
                    "updated_at": "2024-11-08T20:21:40.430984",
                    "data_loader_start_time": "2024-11-08T20:19:49.046128",
                    "data_loader_end_time": "2024-11-08T20:21:02.267585",
                    "check_start_time": "2024-11-08T20:21:02.299008",
                    "check_end_time": "2024-11-08T20:21:40.372310",
                    "result_type": "CommandResult",
                    "status": "complete",
                    "step_number": null,

                    /* check result specific info */
                    "input_data": { input data },
                    "verification_data": { verification data },
                    "passed": false,
                    "answer": "The business registration verification has failed due to critical discrepancies in the registration number, high-risk fraud indicators, and failed visual inspection of the provided document.",
                    "explanation": "This task involves verifying the business registration information provided by the applicant against the documented incorporation information extracted from the submitted documents.",
                    "payload": { check output },
                    "alerts": {
                        "registration_number": "The self-attested registration number does not match the documented number.",
                    },
                    "recommendation": "Failed",
                    "instructions": null,
                    "follow_up": "",
                    "evidence": null,
                    "error": null,

                    /* status messages emitted during the execution of the check */
                    "status_messages": [
                        { status message },
                        ...
                    ]
                },
                ...
            ]
        },
        ...
    ],
    "count": 4
}

All check result objects contain the following key fields:

agent_key
string

The unique identifier of the agent.

command_id
string

The unique identifier of the command.

command_name
string

The name of the command.

created_at
string

The timestamp when the check result was created.

updated_at
string

The timestamp when the check result was last updated.

status
string

The current status of the check result (e.g., “pending”, “completed”, “failed”).

input_data
object

The input data used for the check.

verification_data
object

The verification data used for the check. Input data will be compared against this data.

passed
boolean

Whether the check passed.

answer
string

The answer to the check.

explanation
string

The explanation of the check result.

payload
object

The payload of the check output. Each check implements different payload schema. See reference below for specific output payload for each check.

alerts
array

An array of alerts.

​
Check Result payload reference:

Here are detailed descriptions of the payload for each check:

Run CheckIncorporation document verification