> ## 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 Combined: Inputs, Cost & CLI Example
> Reading combined job and subprocess status or its terminal enrichment bundle. 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_combined:{"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 a combined job. When `status` is `completed`, the `record` object contains the entity resolution result and the requested enrichment.",
"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"
},
"subprocesses": {
"type": "object",
"description": "Status of each requested subprocess while a combined job is running. Added locally because Kernel's official processing_with_subprocesses example documents this response field but CombinedJobStatus omits it.",
"properties": {
"entity-resolution": {
"type": "string",
"enum": [
"pending",
"processing",
"completed",
"failed"
]
},
"resolve-parent": {
"type": "string",
"enum": [
"pending",
"processing",
"completed",
"failed"
]
},
"firmographics": {
"type": "string",
"enum": [
"pending",
"processing",
"completed",
"failed"
]
}
},
"additionalProperties": false
},
"record": {
"type": "object",
"properties": {
"kernel_id": {
"type": [
"string",
"null"
],
"description": "The unique identifier for the resolved entity in Kernel's database. `null` when no entity is resolved."
},
"identity_type": {
"type": "string",
"description": "Type of identity resolved.",
"enum": [
"legal_entity",
"trading_entity"
]
},
"identity_resolution_confidence": {
"type": "string",
"description": "Confidence that the resolved identity is correct.",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"identity_resolution_reasoning": {
"type": "string",
"description": "Explanation of how the identity was resolved."
},
"legal_info": {
"type": [
"object",
"null"
],
"description": "Legal entity information. `null` when no entity is resolved.",
"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",
"null"
],
"description": "Trading entity information. `null` when no entity is resolved.",
"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 entity. `null` when no entity is resolved.",
"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 profile match. Only present when `match_to_linkedin` is true.",
"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
},
"firmographics": {
"type": "object",
"properties": {
"kernel_id": {
"type": "string",
"description": "The unique identifier for the entity in Kernel's database."
},
"op_status": {
"type": [
"object",
"null"
],
"description": "Operational status of the entity. `null` when not yet determined.",
"properties": {
"operational_status": {
"type": [
"string",
"null"
],
"description": "Current operational status.",
"enum": [
"Active",
"Out of business",
"Absorbed",
"Undetermined",
null
]
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the operational status was determined."
}
},
"additionalProperties": false
},
"location": {
"type": [
"object",
"null"
],
"description": "Operating and registered addresses. `null` when not yet determined.",
"properties": {
"operating": {
"type": [
"object",
"null"
],
"description": "Operating address.",
"properties": {
"street": {
"type": [
"string",
"null"
],
"description": "Street address."
},
"city": {
"type": [
"string",
"null"
],
"description": "City."
},
"state": {
"type": [
"string",
"null"
],
"description": "State or province."
},
"country": {
"type": [
"string",
"null"
],
"description": "Country."
},
"postcode": {
"type": [
"string",
"null"
],
"description": "ZIP or postal code."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the address was determined."
}
},
"additionalProperties": false
},
"registered": {
"type": [
"object",
"null"
],
"description": "Registered/legal address.",
"properties": {
"street": {
"type": [
"string",
"null"
],
"description": "Street address."
},
"city": {
"type": [
"string",
"null"
],
"description": "City."
},
"state": {
"type": [
"string",
"null"
],
"description": "State or province."
},
"country": {
"type": [
"string",
"null"
],
"description": "Country."
},
"postcode": {
"type": [
"string",
"null"
],
"description": "ZIP or postal code."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the address was determined."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"headcount": {
"type": [
"object",
"null"
],
"description": "Headcount data. `null` when not yet determined.",
"properties": {
"count": {
"type": [
"number",
"null"
],
"description": "Recommended (headline) headcount. Kernel automatically picks the entity-direct or consolidated figure based on entity type; equals `count_entity` or `count_consolidated`."
},
"count_entity": {
"type": [
"number",
"null"
],
"description": "Entity-direct headcount, excluding subsidiaries."
},
"count_consolidated": {
"type": [
"number",
"null"
],
"description": "Consolidated headcount including subsidiaries."
},
"confidence": {
"type": [
"string",
"null"
],
"description": "Confidence in the headcount figure.",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
null
]
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the headcount was determined."
}
},
"additionalProperties": false
},
"revenue": {
"type": [
"object",
"null"
],
"description": "Revenue data. `null` when not yet determined.",
"properties": {
"usd": {
"type": [
"number",
"null"
],
"description": "Recommended (headline) annual revenue in USD. Kernel automatically picks the entity-direct or consolidated figure based on entity type; equals `usd_entity` or `consolidated_usd`."
},
"usd_entity": {
"type": [
"number",
"null"
],
"description": "Entity-direct annual revenue in USD, excluding subsidiaries."
},
"consolidated_usd": {
"type": [
"number",
"null"
],
"description": "Consolidated annual revenue in USD including subsidiaries."
},
"confidence": {
"type": [
"string",
"null"
],
"description": "Confidence in the revenue figure.",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
null
]
},
"local_currency": {
"type": [
"string",
"null"
],
"description": "The local currency of the recommended source figure, before USD conversion."
},
"local_currency_entity": {
"type": [
"string",
"null"
],
"description": "The local currency of the entity-direct source figure, before USD conversion."
},
"local": {
"type": [
"number",
"null"
],
"description": "Recommended annual revenue in local currency, matching `usd`."
},
"local_entity": {
"type": [
"number",
"null"
],
"description": "Entity-direct annual revenue in local currency."
},
"consolidated_local": {
"type": [
"number",
"null"
],
"description": "Consolidated revenue in local currency."
},
"consolidated_currency": {
"type": [
"string",
"null"
],
"description": "The currency of the consolidated source figure, before USD conversion."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of how the revenue figure was determined."
},
"source": {
"type": [
"string",
"null"
],
"description": "Source of the revenue data. One of: `identified`, `estimated`.",
"enum": [
"identified",
"estimated",
null
]
}
},
"additionalProperties": false
}
},
"required": [
"kernel_id",
"op_status",
"location",
"headcount",
"revenue"
],
"additionalProperties": false
},
"parentage": {
"type": "object",
"properties": {
"kernel_id": {
"type": "string",
"description": "The kernel_id of the queried entity."
},
"parent": {
"type": [
"object",
"null"
],
"description": "The immediate parent entity. `null` when the entity has no parent (standalone).",
"properties": {
"kernel_id": {
"type": "string",
"description": "Kernel ID of the parent entity."
},
"trading_name": {
"type": [
"string",
"null"
],
"description": "Parent trading name."
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Parent registered legal name."
},
"website": {
"type": [
"string",
"null"
],
"description": "Parent company website URL."
},
"country": {
"type": [
"string",
"null"
],
"description": "Parent country (ISO 3166-1 alpha-2 or full name)."
},
"entity_category": {
"type": [
"string",
"null"
],
"description": "Parent entity category. One of: Company, Government, Education.",
"enum": [
"Company",
"Government",
"Education",
null
]
},
"entity_sub_category": {
"type": [
"string",
"null"
],
"description": "Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of why this entity was identified as the parent."
},
"confidence": {
"type": [
"string",
"null"
],
"description": "Confidence in the parent identification. One of: HIGH, MEDIUM, LOW.",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
null
]
}
},
"required": [
"kernel_id"
],
"additionalProperties": false
},
"top_parent": {
"type": [
"object",
"null"
],
"description": "The ultimate parent entity at the top of the corporate hierarchy. For standalone entities, top_parent points to the entity itself and parent is null.",
"properties": {
"kernel_id": {
"type": "string",
"description": "Kernel ID of the parent entity."
},
"trading_name": {
"type": [
"string",
"null"
],
"description": "Parent trading name."
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Parent registered legal name."
},
"website": {
"type": [
"string",
"null"
],
"description": "Parent company website URL."
},
"country": {
"type": [
"string",
"null"
],
"description": "Parent country (ISO 3166-1 alpha-2 or full name)."
},
"entity_category": {
"type": [
"string",
"null"
],
"description": "Parent entity category. One of: Company, Government, Education.",
"enum": [
"Company",
"Government",
"Education",
null
]
},
"entity_sub_category": {
"type": [
"string",
"null"
],
"description": "Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of why this entity was identified as the parent."
},
"confidence": {
"type": [
"string",
"null"
],
"description": "Confidence in the parent identification. One of: HIGH, MEDIUM, LOW.",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
null
]
}
},
"required": [
"kernel_id"
],
"additionalProperties": false
},
"top_operating_parent": {
"type": [
"object",
"null"
],
"description": "The top operating parent entity in the corporate hierarchy, excluding HoldCo/investment vehicles. `null` when the entity is standalone or has no operating parent.",
"properties": {
"kernel_id": {
"type": "string",
"description": "Kernel ID of the parent entity."
},
"trading_name": {
"type": [
"string",
"null"
],
"description": "Parent trading name."
},
"legal_name": {
"type": [
"string",
"null"
],
"description": "Parent registered legal name."
},
"website": {
"type": [
"string",
"null"
],
"description": "Parent company website URL."
},
"country": {
"type": [
"string",
"null"
],
"description": "Parent country (ISO 3166-1 alpha-2 or full name)."
},
"entity_category": {
"type": [
"string",
"null"
],
"description": "Parent entity category. One of: Company, Government, Education.",
"enum": [
"Company",
"Government",
"Education",
null
]
},
"entity_sub_category": {
"type": [
"string",
"null"
],
"description": "Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of why this entity was identified as the parent."
},
"confidence": {
"type": [
"string",
"null"
],
"description": "Confidence in the parent identification. One of: HIGH, MEDIUM, LOW.",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
null
]
}
},
"required": [
"kernel_id"
],
"additionalProperties": false
},
"regional_subsidiary": {
"type": "object",
"properties": {
"is_regional": {
"type": [
"boolean",
"null"
],
"description": "Whether the entity operates as a regional subsidiary. `null` when not yet determined."
},
"regional_scope": {
"type": [
"string",
"null"
],
"description": "The country scope of the regional operation. `null` when not a regional subsidiary or not yet determined."
},
"reasoning": {
"type": [
"string",
"null"
],
"description": "Explanation of the regional subsidiary classification."
}
},
"additionalProperties": false
}
},
"required": [
"kernel_id",
"regional_subsidiary"
],
"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": [
"kernel_id",
"identity_resolution_confidence",
"identity_resolution_reasoning",
"legal_info",
"trading_info",
"entity_classification"
],
"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_combined --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`.