Kernel.ai: Kernel Get Entity Resolution

Get the status and matched company record of a company match job, given its job ID.

Tool ID: kernel_get_entity_resolution

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'kernel_get_entity_resolution',
  {
    "job_id": "job_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute kernel_get_entity_resolution --input '{
  "job_id": "job_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "status": "pending"
  }
}

Use deepline describe kernel_get_entity_resolution --json for the latest machine-readable contract.

Input reference

Returns the status and result of an entity resolution job. When status is completed, the record object contains the resolved entity data.

Name	Type	Required	Default	Details
`payload.job_id`	`string`	Yes	—	Job ID returned by the POST endpoint

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	No	—	Unique identifier for the job. Present when `status` is `pending`, `processing`, or `completed`.
`result.data.jobid`	`string`	No	—	Unique identifier for the job. Present only when `status` is `failed`.
`result.data.status`	`"pending" \| "processing" \| "completed" \| "failed"`	Yes	—	Current status of the job. Terminal states are `completed` and `failed`. Allowed: `pending`, `processing`, `completed`, `failed`.
`result.data.created_at`	`string`	No	—	ISO 8601 timestamp when the job was created. Format: `date-time`.
`result.data.completed_at`	`string`	No	—	ISO 8601 timestamp when the job reached a terminal state. Format: `date-time`.
`result.data.record`	`object`	No	—	—
`result.data.record.kernel_id`	`string \| null`	No	—	A 10-digit unique identifier for the resolved entity in Kernel’s database. The same company always resolves to the same kernel_id. Null when the entity could not be determined.
`result.data.record.identity_type`	`"legal_entity" \| "trading_entity"`	Yes	—	The resolved identity classification. Allowed: `legal_entity`, `trading_entity`.
`result.data.record.identity_resolution_confidence`	`"HIGH" \| "MEDIUM" \| "LOW"`	Yes	—	Overall confidence in the identity resolution. Allowed: `HIGH`, `MEDIUM`, `LOW`.
`result.data.record.identity_resolution_reasoning`	`string`	Yes	—	A brief explanation of why the entity was identified as this account.
`result.data.record.legal_info`	`object`	Yes	—	—
`result.data.record.legal_info.country`	`string \| null`	Yes	—	Country of the legal entity.
`result.data.record.legal_info.reasoning`	`string`	Yes	—	Explanation of how the legal entity was identified.
`result.data.record.legal_info.trading_name`	`string \| null`	Yes	—	Trading name associated with the legal entity.
`result.data.record.legal_info.confidence`	`"HIGH" \| "MEDIUM" \| "LOW"`	Yes	—	Confidence in the legal entity info. Allowed: `HIGH`, `MEDIUM`, `LOW`.
`result.data.record.legal_info.legal_name`	`string \| null`	Yes	—	Registered legal name.
`result.data.record.legal_info.website`	`string \| null`	Yes	—	Official URL of the legal entity.
`result.data.record.trading_info`	`object`	Yes	—	—
`result.data.record.trading_info.country`	`string \| null`	Yes	—	Country of the trading entity’s operational region.
`result.data.record.trading_info.website`	`string \| null`	Yes	—	Primary trading website URL.
`result.data.record.trading_info.reasoning`	`string`	Yes	—	Explanation of how the trading identity was identified.
`result.data.record.trading_info.trading_name`	`string \| null`	Yes	—	Primary trading name.
`result.data.record.trading_info.confidence`	`"HIGH" \| "MEDIUM" \| "LOW"`	Yes	—	Confidence in the trading identity info. Allowed: `HIGH`, `MEDIUM`, `LOW`.
`result.data.record.entity_classification`	`object \| null`	No	—	Classification of the resolved entity by industry/domain. Null when classification is unavailable.
`result.data.record.entity_classification.type`	`string`	Yes	—	Entity category. One of: Company, Government, Education.
`result.data.record.entity_classification.subtype`	`string`	Yes	—	Entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment.
`result.data.record.entity_classification.reasoning`	`string \| null`	No	—	Explanation of the classification.
`result.data.record.linkedin`	`object \| null`	No	—	LinkedIn company profile match. Only present when `match_to_linkedin` was set to `true` in the request.
`result.data.record.linkedin.url`	`string \| null`	No	—	Full LinkedIn company profile URL.
`result.data.record.linkedin.slug`	`string \| null`	No	—	Company slug extracted from the LinkedIn URL.
`result.data.record.linkedin.match_type`	`"actual" \| "indicative" \| "none"`	No	—	How the LinkedIn profile was matched. `actual` is a verified direct match. `indicative` is a best-guess match. `none` when no match was found. Allowed: `actual`, `indicative`, `none`.
`result.data.record.linkedin.reasoning`	`string \| null`	No	—	Explanation of how the LinkedIn match was determined.
`result.data.record.external_id`	`string`	No	—	Echoed back from your request. Present only when you included an `external_id` in the submitted record. Use it to correlate this result with the record you sent.
`result.data.error_message`	`string`	No	—	Error message. Present when `status` is `failed`.
`result.data.error_type`	`string`	No	—	Machine-readable error type. Present when `status` is `failed`. One of: `kernel_id_not_found`, `unknown`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation