Skip to main content
GET
Get crosscheck result
Returns the status and result of a crosscheck job started with POST /v1/crosscheck. When status is completed, the record field contains:
  • kernel_id for the resolved entity, and your external_id echoed back
  • identity — the resolution result (identity_type, identity_resolution_confidence, identity_resolution_reasoning, legal_info, trading_info, entity_classification)
  • linkedin — the LinkedIn match, if match_to_linkedin was requested
  • crosscheck — the recommended action, duplicate grouping, and operational status, or null if the pass did not run. See Crosscheck not run.
  • parentage — the corporate hierarchy, in the same shape as GET /v1/combined/{job_id}. null under the same conditions as crosscheck.

Completed response

Reading the crosscheck result

An action of None means no change is recommended for the record.

Reading the parentage result

parentage matches the shape returned by GET /v1/combined/{job_id}, so hierarchy reads the same wherever it appears. Each entity carries kernel_id, trading_name, legal_name, website, country, entity_category, entity_sub_category, and confidence. Crosscheck adds external_id, populated when that parent also exists in your CRM.

Crosscheck not run

The pass is skipped when no entity is resolved, or when the external_id does not match an account in your Kernel dataset. The job still completes, crosscheck and parentage are both null, and the crosscheck portion of the credit cost is refunded:

Failed response

If the job fails, the response uses jobid instead of id and includes error_message and error_type:

Authorizations

x-api-key
string
header
required

Include your API key in the x-api-key header.

Path Parameters

job_id
string
required

Job ID returned by the POST endpoint

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

Job status response

status
enum<string>
required

Current status of the job. Terminal states are completed and failed.

Available options:
pending,
processing,
completed,
failed
id
string

Unique identifier for the job. Present when status is pending, processing, or completed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

jobid
string

Unique identifier for the job. Present only when status is failed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

created_at
string<date-time>

ISO 8601 timestamp when the job was created.

Example:

"2025-06-05T12:00:00Z"

completed_at
string<date-time>

ISO 8601 timestamp when the job reached a terminal state.

Example:

"2025-06-05T12:00:05Z"

record
object

Crosscheck result. Present when status is completed.

error_message
string

Error message. Present when status is failed.

error_type
string

Machine-readable error category. Present when status is failed.