> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Kernel Get Entity Resolution: Inputs, Cost & CLI Example
> Reading entity-resolution status and the terminal canonical company record. Includes inputs, outputs, costs, and Deepline CLI examples for GTM automation.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=kernel_get_entity_resolution:{"job_id":"{{job_id}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------- | -------- | -------- | ------- | ------------------------------------ |
| `payload.job_id` | `string` | Yes | | Job ID returned by the POST endpoint |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Returns the status and result of an entity resolution job. When `status` is `completed`, the `record` object contains the resolved entity data.",
"properties": {
"job_id": {
"type": "string",
"description": "Job ID returned by the POST endpoint"
}
},
"required": [
"job_id"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the job. Present when `status` is `pending`, `processing`, or `completed`."
},
"jobid": {
"type": "string",
"description": "Unique identifier for the job. Present only when `status` is `failed`."
},
"status": {
"type": "string",
"description": "Current status of the job. Terminal states are `completed` and `failed`.",
"enum": [
"pending",
"processing",
"completed",
"failed"
]
},
"created_at": {
"type": "string",
"description": "ISO 8601 timestamp when the job was created.",
"format": "date-time"
},
"completed_at": {
"type": "string",
"description": "ISO 8601 timestamp when the job reached a terminal state.",
"format": "date-time"
},
"record": {
"type": "object",
"properties": {
"kernel_id": {
"type": [
"string",
"null"
],
"description": "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."
},
"identity_type": {
"type": "string",
"description": "The resolved identity classification.",
"enum": [
"legal_entity",
"trading_entity"
]
},
"identity_resolution_confidence": {
"type": "string",
"description": "Overall confidence in the identity resolution.",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"identity_resolution_reasoning": {
"type": "string",
"description": "A brief explanation of why the entity was identified as this account."
},
"legal_info": {
"type": "object",
"properties": {
"country": {
"type": [
"string",
"null"
],
"description": "Country of the legal entity."
},
"reasoning": {
"type": "string",
"description": "Explanation of how the legal entity was identified."
},
"trading_name": {
"type": [
"string",
"null"
],
"description": "Trading name associated with the legal entity."
},
"confidence": {
"type": "string",
"description": "Confidence in the legal entity info.",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Registered legal name."
},
"website": {
"type": [
"string",
"null"
],
"description": "Official URL of the legal entity."
}
},
"required": [
"country",
"reasoning",
"trading_name",
"confidence",
"legal_name",
"website"
],
"additionalProperties": false
},
"trading_info": {
"type": "object",
"properties": {
"country": {
"type": [
"string",
"null"
],
"description": "Country of the trading entity's operational region."
},
"website": {
"type": [
"string",
"null"
],
"description": "Primary trading website URL."
},
"reasoning": {
"type": "string",
"description": "Explanation of how the trading identity was identified."
},
"trading_name": {
"type": [
"string",
"null"
],
"description": "Primary trading name."
},
"confidence": {
"type": "string",
"description": "Confidence in the trading identity info.",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
}
},
"required": [
"country",
"website",
"reasoning",
"trading_name",
"confidence"
],
"additionalProperties": false
},
"entity_classification": {
"type": [
"object",
"null"
],
"description": "Classification of the resolved entity by industry/domain. Null when classification is unavailable.",
"properties": {
"type": {
"type": "string",
"description": "Entity category. One of: Company, Government, Education."
},
"subtype": {
"type": "string",
"description": "Entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of the classification."
}
},
"required": [
"type",
"subtype"
],
"additionalProperties": false
},
"linkedin": {
"type": [
"object",
"null"
],
"description": "LinkedIn company profile match. Only present when `match_to_linkedin` was set to `true` in the request.",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Full LinkedIn company profile URL."
},
"slug": {
"type": [
"string",
"null"
],
"description": "Company slug extracted from the LinkedIn URL."
},
"match_type": {
"type": "string",
"description": "How the LinkedIn profile was matched. `actual` is a verified direct match; `indicative` is a best-guess match; `none` when no match was found.",
"enum": [
"actual",
"indicative",
"none"
]
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the LinkedIn match was determined."
}
},
"additionalProperties": false
},
"external_id": {
"type": "string",
"description": "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."
}
},
"required": [
"identity_type",
"identity_resolution_confidence",
"identity_resolution_reasoning",
"legal_info",
"trading_info"
],
"additionalProperties": false
},
"error_message": {
"type": "string",
"description": "Error message. Present when `status` is `failed`."
},
"error_type": {
"type": "string",
"description": "Machine-readable error type. Present when `status` is `failed`. One of: `kernel_id_not_found`, `unknown`."
}
},
"required": [
"status"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute kernel_get_entity_resolution --payload '{
"job_id": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.