Skip to main content
GET
/
getCheckResults
Get check all results for a job
curl --request GET \
  --url https://api.parcha.ai/api/v1/getCheckResults \
  --header 'Authorization: Bearer <token>'
This endpoint retrieves all check results associated with a specific job.

​
Endpoint

GET /getCheckResults

​
Parameters

​
job_id
string
required
The unique identifier of the job.

​
Response

Returns an array of check result objects.
​
check_results
array
An array of check result objects for the job.

​
Error Responses

​
error
string
A description of the error that occurred.
Status CodeDescription
404Job not found
401Unauthorized access
500Internal server error

​
Example Request

curl -X GET 'https://api.parcha.ai/getCheckResults?job_id=123456' \
-H 'Authorization: Bearer YOUR_API_KEY'

​
Example Response

[
  {
    "id": "check_result_1",
    "check_id": "business_profile_check",
    "status": "completed",
    "result": {
      "business_name": "Acme Corp",
      "industry": "Technology",
      "risk_score": 15
    },
    "status_messages": [
      {
        "message": "Check started",
        "timestamp": "2023-06-15T10:30:00Z"
      },
      {
        "message": "Data retrieved",
        "timestamp": "2023-06-15T10:31:00Z"
      },
      {
        "message": "Check completed",
        "timestamp": "2023-06-15T10:32:00Z"
      }
    ],
    "created_at": "2023-06-15T10:30:00Z",
    "updated_at": "2023-06-15T10:32:00Z"
  },
  {
    "id": "check_result_2",
    "check_id": "adverse_media_screening",
    "status": "completed",
    "result": {
      "findings": [],
      "risk_level": "low"
    },
    "status_messages": [
      {
        "message": "Check started",
        "timestamp": "2023-06-15T10:30:00Z"
      },
      {
        "message": "Media search completed",
        "timestamp": "2023-06-15T10:33:00Z"
      }
    ],
    "created_at": "2023-06-15T10:30:00Z",
    "updated_at": "2023-06-15T10:33:00Z"
  }
]

​
Use Cases

This endpoint is useful for:
  • Retrieving all check results after a job completes
  • Monitoring the status of multiple checks in a single job
  • Building dashboards that display comprehensive job results
  • Accessing detailed findings from all checks performed

Authorizations

​
Authorization
string
header
required

API key obtained from your Parcha account settings. Include as Bearer token in the Authorization header.

Query Parameters

​
job_id
string
required

The ID of the job to retrieve check results for

Response

Check results retrieved successfully