> ## 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.ai: Kernel Get Resolve Parent
> Get the status and parent-company hierarchy of a parent lookup job, given its job ID. Includes inputs, outputs, SDK V2 examples, and Deepline cost.
Get the status and parent-company hierarchy of a parent lookup job, given its job ID.
> [!NOTE]
>
> Tool ID: `kernel_get_resolve_parent`
## Run this action
Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.
```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'kernel_get_resolve_parent',
{
"job_id": "job_123"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute kernel_get_resolve_parent --input '{
"job_id": "job_123"
}' --json
```
## Example response
The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"data": {
"status": "pending"
}
}
```
Use `deepline describe kernel_get_resolve_parent --json` for the latest machine-readable contract.
## Input reference
Returns the status and result of a parent hierarchy resolution job. When `status` is `completed`, the `record` object contains the parent hierarchy data.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.job_id` | `string` | Yes | — | Job ID returned by the POST endpoint |
Show raw input schema
### Input JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"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 reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | No | — | Unique identifier for the job. Present when `status` is `pending`, `processing`, or `completed`. |
| `result.data.jobid` | `string` | No | — | Unique identifier for the job. Present only when `status` is `failed`. |
| `result.data.status` | `"pending" \| "processing" \| "completed" \| "failed"` | Yes | — | Current status of the job. Terminal states are `completed` and `failed`. Allowed: `pending`, `processing`, `completed`, `failed`. |
| `result.data.created_at` | `string` | No | — | ISO 8601 timestamp when the job was created. Format: `date-time`. |
| `result.data.completed_at` | `string` | No | — | ISO 8601 timestamp when the job reached a terminal state. Format: `date-time`. |
| `result.data.record` | `object` | No | — | — |
| `result.data.record.kernel_id` | `string` | Yes | — | The kernel\_id of the queried entity. |
| `result.data.record.parent` | `object \| null` | No | — | The immediate parent entity. `null` when the entity has no parent (standalone). |
| `result.data.record.parent.kernel_id` | `string` | Yes | — | Kernel ID of the parent entity. |
| `result.data.record.parent.trading_name` | `string \| null` | No | — | Parent trading name. |
| `result.data.record.parent.legal_name` | `string \| null` | No | — | Parent registered legal name. |
| `result.data.record.parent.website` | `string \| null` | No | — | Parent company website URL. |
| `result.data.record.parent.country` | `string \| null` | No | — | Parent country (ISO 3166-1 alpha-2 or full name). |
| `result.data.record.parent.entity_category` | `"Company" \| "Government" \| "Education" \| null` | No | — | Parent entity category. One of: Company, Government, Education. Allowed: `Company`, `Government`, `Education`, `null`. |
| `result.data.record.parent.entity_sub_category` | `string \| null` | No | — | Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment. |
| `result.data.record.parent.reasoning` | `string \| null` | No | — | Explanation of why this entity was identified as the parent. |
| `result.data.record.parent.confidence` | `"HIGH" \| "MEDIUM" \| "LOW" \| null` | No | — | Confidence in the parent identification. One of: HIGH, MEDIUM, LOW. Allowed: `HIGH`, `MEDIUM`, `LOW`, `null`. |
| `result.data.record.top_parent` | `object \| null` | No | — | 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. |
| `result.data.record.top_parent.kernel_id` | `string` | Yes | — | Kernel ID of the parent entity. |
| `result.data.record.top_parent.trading_name` | `string \| null` | No | — | Parent trading name. |
| `result.data.record.top_parent.legal_name` | `string \| null` | No | — | Parent registered legal name. |
| `result.data.record.top_parent.website` | `string \| null` | No | — | Parent company website URL. |
| `result.data.record.top_parent.country` | `string \| null` | No | — | Parent country (ISO 3166-1 alpha-2 or full name). |
| `result.data.record.top_parent.entity_category` | `"Company" \| "Government" \| "Education" \| null` | No | — | Parent entity category. One of: Company, Government, Education. Allowed: `Company`, `Government`, `Education`, `null`. |
| `result.data.record.top_parent.entity_sub_category` | `string \| null` | No | — | Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment. |
| `result.data.record.top_parent.reasoning` | `string \| null` | No | — | Explanation of why this entity was identified as the parent. |
| `result.data.record.top_parent.confidence` | `"HIGH" \| "MEDIUM" \| "LOW" \| null` | No | — | Confidence in the parent identification. One of: HIGH, MEDIUM, LOW. Allowed: `HIGH`, `MEDIUM`, `LOW`, `null`. |
| `result.data.record.top_operating_parent` | `object \| null` | No | — | The top operating parent entity in the corporate hierarchy, excluding HoldCo/investment vehicles. `null` when the entity is standalone or has no operating parent. |
| `result.data.record.top_operating_parent.kernel_id` | `string` | Yes | — | Kernel ID of the parent entity. |
| `result.data.record.top_operating_parent.trading_name` | `string \| null` | No | — | Parent trading name. |
| `result.data.record.top_operating_parent.legal_name` | `string \| null` | No | — | Parent registered legal name. |
| `result.data.record.top_operating_parent.website` | `string \| null` | No | — | Parent company website URL. |
| `result.data.record.top_operating_parent.country` | `string \| null` | No | — | Parent country (ISO 3166-1 alpha-2 or full name). |
| `result.data.record.top_operating_parent.entity_category` | `"Company" \| "Government" \| "Education" \| null` | No | — | Parent entity category. One of: Company, Government, Education. Allowed: `Company`, `Government`, `Education`, `null`. |
| `result.data.record.top_operating_parent.entity_sub_category` | `string \| null` | No | — | Parent entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment. |
| `result.data.record.top_operating_parent.reasoning` | `string \| null` | No | — | Explanation of why this entity was identified as the parent. |
| `result.data.record.top_operating_parent.confidence` | `"HIGH" \| "MEDIUM" \| "LOW" \| null` | No | — | Confidence in the parent identification. One of: HIGH, MEDIUM, LOW. Allowed: `HIGH`, `MEDIUM`, `LOW`, `null`. |
| `result.data.record.regional_subsidiary` | `object` | Yes | — | — |
| `result.data.record.regional_subsidiary.is_regional` | `boolean \| null` | No | — | Whether the entity operates as a regional subsidiary. `null` when not yet determined. |
| `result.data.record.regional_subsidiary.regional_scope` | `string \| null` | No | — | The country scope of the regional operation. `null` when not a regional subsidiary or not yet determined. |
| `result.data.record.regional_subsidiary.reasoning` | `string \| null` | No | — | Explanation of the regional subsidiary classification. |
| `result.data.error_message` | `string` | No | — | Error message. Present when `status` is `failed`. |
| `result.data.error_type` | `string` | No | — | Machine-readable error type. Present when `status` is `failed`. One of: `kernel_id_not_found`, `unknown`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
"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
}
```
## Deepline cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
## Related documentation
* [Kernel.ai provider guide](https://deepline.com/docs/providers/kernel/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.