> ## 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 Resolve Parent: Inputs, Cost & CLI Example
> Reading parent-resolution status and terminal hierarchy data. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## 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_resolve_parent:{"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 parent hierarchy resolution job. When `status` is `completed`, the `record` object contains the parent hierarchy 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",
"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
},
"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_resolve_parent --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`.