GET
/
getCheckResultFromJob
Get a specific check result from job
curl --request GET \
  --url https://api.parcha.ai/api/v1/getCheckResultFromJob \
  --header 'Authorization: Bearer <token>'
This endpoint retrieves the result of a specific check from a job.

​
Endpoint

GET /getCheckResultFromJob

​
Parameters

​
job_id
string
required
The unique identifier of the job.
​
agent_instance_id
string
required
The unique identifier of the agent instance.
​
check_id
string
required
The unique identifier of the check.
​
case_type
string
required
The type of the case (e.g., “KYB”, “KYC”).
​
include_status_messages
boolean
default:"true"
Whether to include status messages in the response.

​
Response

​
sources
array
An array of source identifiers used in the check.
​
...
object
The full check result object. Structure may vary based on the type of check.

​
Error Responses

​
error
string
A description of the error that occurred.
Status CodeDescription
404Job or check result not found
403Unauthorized access to agent
500Internal server error

​
Example Request

curl -X GET 'https://api.parcha.ai/getCheckResultFromJob?job_id=123456&agent_instance_id=789012&check_id=345678&case_type=KYB&include_status_messages=true' \
-H 'Authorization: Bearer YOUR_API_KEY'

​
Example Response

{
  "id": "345678",
  "status": "completed",
  "result": {
    "risk_score": 25,
    "findings": [
      {
        "type": "business_name_match",
        "result": "exact_match"
      },
      {
        "type": "address_verification",
        "result": "verified"
      }
    ]
  },
  "sources": ["business_registry", "address_database"],
  "created_at": "2023-06-15T10:30:00Z",
  "updated_at": "2023-06-15T10:35:00Z"
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from the authentication endpoint

Query Parameters

​
job_id
string
required

The unique identifier of the job

​
agent_instance_id
string
required

The unique identifier of the agent instance

​
check_id
string
required

The unique identifier of the check

​
case_type
enum<string>
required

The type of the case

Available options:
kyb,
kyc,
entity
​
include_status_messages
boolean
default:true

Whether to include status messages in the response

Response

Check result retrieved successfully