Completed result

This object is returned in record when you poll GET /v1/entity-resolution/{job_id} and status is completed. The result contains the resolved identity type and structured legal and trading information. Confidence levels are HIGH, MEDIUM, or LOW.

Top-level fields

`kernel_id`

string | null — A 10-digit unique identifier for the resolved entity in Kernel’s central database. The same company always resolves to the same kernel_id. null when the entity could not be determined.

`identity_type`

string — The resolved identity classification. One of:

Value	Meaning
`legal_entity`	Resolved to a registered legal entity
`trading_entity`	Resolved to a trading identity

`identity_resolution_confidence`

string — Overall confidence in the identity resolution. One of: HIGH, MEDIUM, LOW.

`identity_resolution_reasoning`

string — A brief explanation of why the entity was identified as this account, citing the key evidence used.

`entity_classification`

object | null — Classification of the resolved entity by entity category. null when classification is unavailable. Contains:

Field	Type	Description
`type`	string	Entity category (e.g. `"Company"`, `"Government"`, `"Education"`)
`subtype`	string	Entity sub-category (e.g. `"Operating"`, `"HoldCo/Investment"`, `"Business Unit"`)
`reasoning`	`string	null`	Explanation of the classification

`legal_info`

object — Information about the legal entity.

Field	Type	Description
`legal_name`	`string	null`	Registered legal name (e.g. `"Stripe, Inc."`)
`website`	`string	null`	Official URL of the legal entity
`country`	`string	null`	Country of the legal entity
`trading_name`	`string	null`	Trading name associated with the legal entity
`confidence`	`string`	Confidence in the legal entity info. One of: `HIGH`, `MEDIUM`, `LOW`
`reasoning`	`string`	Explanation of how the legal entity was identified

`trading_info`

object — Information about the trading identity.

Field	Type	Description
`trading_name`	`string	null`	Primary trading name (e.g. `"Stripe"`)
`website`	`string	null`	Primary trading website URL
`country`	`string	null`	Country of the trading entity’s operational region
`confidence`	`string`	Confidence in the trading identity info. One of: `HIGH`, `MEDIUM`, `LOW`
`reasoning`	`string`	Explanation of how the trading identity was identified

`linkedin`

object | null — LinkedIn company profile match. Only present when match_to_linkedin was set to true in the request.

Field	Type	Description
`url`	`string \| null`	Full LinkedIn company profile URL
`slug`	`string \| null`	Company slug extracted from the LinkedIn URL
`match_type`	`string \| null`	How the profile was matched. One of: `actual`, `indicative`, `none`
`reasoning`	`string \| null`	Explanation of how the LinkedIn match was determined

`external_id`

string — 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.

Examples

Matched entity

{
  "kernel_id": "6347422643",
  "identity_type": "legal_entity",
  "identity_resolution_confidence": "HIGH",
  "identity_resolution_reasoning": "Company identified as Stripe, Inc. via legal name, website, and country alignment.",
  "legal_info": {
    "country": "US",
    "reasoning": "Confirmed via Stripe terms of service page.",
    "trading_name": "Stripe",
    "confidence": "HIGH",
    "legal_name": "Stripe, Inc.",
    "website": "https://stripe.com"
  },
  "trading_info": {
    "country": "US",
    "website": "https://stripe.com",
    "reasoning": "Primary brand site confirmed via domain ownership.",
    "trading_name": "Stripe",
    "confidence": "HIGH"
  },
  "entity_classification": {
    "type": "Company",
    "subtype": "Operating",
    "reasoning": "Classified as an operating company based on commercial activity."
  },
  "linkedin": {
    "url": "https://www.linkedin.com/company/stripe",
    "slug": "stripe",
    "match_type": "actual",
    "reasoning": "Matched via verified website domain stripe.com."
  },
  "external_id": "stripe-001"
}

No match — entity not found in Kernel's database

{
  "kernel_id": null,
  "identity_resolution_confidence": "HIGH",
  "identity_resolution_reasoning": "Company identified as Acme Inc. via legal name and website alignment.",
  "legal_info": null,
  "trading_info": null,
  "entity_classification": null
}

When identity resolution runs but the entity cannot be matched to a Kernel account, kernel_id is null and all identity detail fields (legal_info, trading_info, entity_classification) are null. The identity_resolution_confidence and identity_resolution_reasoning fields remain populated to explain the resolution attempt. If the linkedin field was requested (match_to_linkedin: true), it will be null in the no-match case.

Getting started

API reference

API keys & Webhooks

Completed result

Top-level fields

`kernel_id`

`identity_type`

`identity_resolution_confidence`

`identity_resolution_reasoning`

`entity_classification`

`legal_info`

`trading_info`

`linkedin`

`external_id`

Examples

​Top-level fields

​kernel_id

​identity_type

​identity_resolution_confidence

​identity_resolution_reasoning

​entity_classification

​legal_info

​trading_info

​linkedin

​external_id

​Examples

Top-level fields

`kernel_id`

`identity_type`

`identity_resolution_confidence`

`identity_resolution_reasoning`

`entity_classification`

`legal_info`

`trading_info`

`linkedin`

`external_id`

Examples