> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parcha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Result Object

> Response schema for check results

When you fetch the results of a Job using the `/getJobById` or `/getJobByCaseId` endpoint, the response will contain a check result object with metadata about the check execution and a check-specific payloads for each check that was run. You can find the results of a specific check by filtering the `command_name` in the response.

<ResponseField name="agent_key" type="string">
  The unique identifier of the agent.
</ResponseField>

<ResponseField name="agent_instance_id" type="string">
  The unique identifier for this instance of the agent.
</ResponseField>

<ResponseField name="command_id" type="string">
  The unique identifier of the command.
</ResponseField>

<ResponseField name="command_name" type="string">
  The name of the command.
</ResponseField>

<ResponseField name="command_desc" type="string">
  A description of what the command does.
</ResponseField>

<ResponseField name="command_instance_id" type="string">
  The unique identifier for this instance of the command.
</ResponseField>

<ResponseField name="data_loader_id" type="string | null">
  The identifier of the data loader used, if any.
</ResponseField>

<ResponseField name="job_id" type="string">
  The identifier of the job this check result belongs to.
</ResponseField>

<ResponseField name="created_at" type="string">
  The timestamp when the check result was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  The timestamp when the check result was last updated.
</ResponseField>

<ResponseField name="data_loader_start_time" type="string | null">
  The timestamp when the data loader started, if applicable.
</ResponseField>

<ResponseField name="data_loader_end_time" type="string | null">
  The timestamp when the data loader finished, if applicable.
</ResponseField>

<ResponseField name="check_start_time" type="string | null">
  The timestamp when the check started.
</ResponseField>

<ResponseField name="check_end_time" type="string | null">
  The timestamp when the check finished.
</ResponseField>

<ResponseField name="result_type" type="string">
  The type of result, typically "CommandResult".
</ResponseField>

<ResponseField name="status" type="string">
  The current status of the check result (e.g., "pending", "complete", "failed").
</ResponseField>

<ResponseField name="step_number" type="number | null">
  The step number in the workflow, if applicable.
</ResponseField>

<ResponseField name="input_data" type="object">
  The input data used for the check.
</ResponseField>

<ResponseField name="verification_data" type="object">
  The verification data used for the check. Input data will be compared against this data.
</ResponseField>

<ResponseField name="passed" type="boolean">
  Whether the check passed.
</ResponseField>

<ResponseField name="answer" type="string">
  A human-readable summary of the check result.
</ResponseField>

<ResponseField name="explanation" type="string">
  A detailed explanation of what was checked and how the result was determined.
</ResponseField>

<ResponseField name="payload" type="object">
  Check-specific result data. The structure of this object varies depending on the type of check that was run. See the individual check result documentation for details:

  * [EIN Document Verification Result](/api-reference/check-results/ein-document-verification)
  * [Incorporation Document Verification Result](/api-reference/check-results/incorporation-document-verification)
  * [Proof of Address Document Verification Result](/api-reference/check-results/proof-of-address-document-verification)
  * [Business Ownership Document Verification Result](/api-reference/check-results/business-ownership-document-verification)
</ResponseField>

<ResponseField name="alerts" type="object">
  An object containing any alerts or warnings generated during the check.
</ResponseField>

<ResponseField name="recommendation" type="string | null">
  A recommended action based on the check result.
</ResponseField>

<ResponseField name="instructions" type="string | null">
  Any instructions related to the check.
</ResponseField>

<ResponseField name="follow_up" type="string | null">
  Any follow-up actions that should be taken.
</ResponseField>

<ResponseField name="evidence" type="object | null">
  Any evidence collected during the check.
</ResponseField>

<ResponseField name="error" type="string | null">
  Any error that occurred during the check.
</ResponseField>

<ResponseField name="status_messages" type="array">
  An array of status messages emitted during the execution of the check.
</ResponseField>

### Example Response

```json theme={null}
{
    "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
}
```