Skip to main content
This object is returned in record when you poll GET /v1/entity-resolution/{job_id} and status is completed. The result contains the resolved entity type and structured legal and brand 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.

entity_type

string — The resolved entity classification. One of:
ValueMeaning
legal_entityResolved to a registered legal entity
trading_entityResolved to a trading/brand identity

entity_resolution_confidence

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

entity_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:
FieldTypeDescription
typestringEntity category (e.g. "Company", "Government", "Education")
subtypestringEntity sub-category (e.g. "Operating", "HoldCo/Investment", "Business Unit")
reasoning`stringnull`Explanation of the classification
object — Information about the legal entity.
FieldTypeDescription
legal_name`stringnull`Registered legal name (e.g. "Stripe, Inc.")
website`stringnull`Official URL of the legal entity
country`stringnull`Country of the legal entity
brand_name`stringnull`Brand name associated with the legal entity
confidencestringConfidence in the legal entity info. One of: HIGH, MEDIUM, LOW
reasoningstringExplanation of how the legal entity was identified

brand_info

object — Information about the brand identity.
FieldTypeDescription
brand_name`stringnull`Primary brand name (e.g. "Stripe")
website`stringnull`Primary brand website URL
country`stringnull`Country of the brand’s operational region
confidencestringConfidence in the brand identity info. One of: HIGH, MEDIUM, LOW
reasoningstringExplanation of how the brand identity was identified

Examples

Matched entity
{
  "kernel_id": "6347422643",
  "entity_type": "legal_entity",
  "entity_resolution_confidence": "HIGH",
  "entity_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.",
    "brand_name": "Stripe, Inc.",
    "confidence": "HIGH",
    "legal_name": "Stripe, Inc.",
    "website": "https://stripe.com"
  },
  "brand_info": {
    "country": "US",
    "website": "https://stripe.com",
    "reasoning": "Primary brand site confirmed via domain ownership.",
    "brand_name": "Stripe",
    "confidence": "HIGH"
  },
  "entity_classification": {
    "type": "Company",
    "subtype": "Operating",
    "reasoning": "Classified as an operating company based on commercial activity."
  }
}
Failed resolution
null
When the identity resolution fails, record is null.