> ## 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 Entity Resolution

> Get the status and matched company record of a company match job, given its job ID. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Get the status and matched company record of a company match job, given its job ID.

> [!NOTE]
>
> Tool ID: `kernel_get_entity_resolution`

## 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_entity_resolution',
  {
    "job_id": "job_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute kernel_get_entity_resolution --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_entity_resolution --json` for the latest machine-readable contract.

## Input reference

Returns the status and result of an entity resolution job. When `status` is `completed`, the `record` object contains the resolved entity data.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.job_id` | `string` | Yes | — | Job ID returned by the POST endpoint |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

## 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 \| null` | No | — | 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. |
| `result.data.record.identity_type` | `"legal_entity" \| "trading_entity"` | Yes | — | The resolved identity classification. Allowed: `legal_entity`, `trading_entity`. |
| `result.data.record.identity_resolution_confidence` | `"HIGH" \| "MEDIUM" \| "LOW"` | Yes | — | Overall confidence in the identity resolution. Allowed: `HIGH`, `MEDIUM`, `LOW`. |
| `result.data.record.identity_resolution_reasoning` | `string` | Yes | — | A brief explanation of why the entity was identified as this account. |
| `result.data.record.legal_info` | `object` | Yes | — | — |
| `result.data.record.legal_info.country` | `string \| null` | Yes | — | Country of the legal entity. |
| `result.data.record.legal_info.reasoning` | `string` | Yes | — | Explanation of how the legal entity was identified. |
| `result.data.record.legal_info.trading_name` | `string \| null` | Yes | — | Trading name associated with the legal entity. |
| `result.data.record.legal_info.confidence` | `"HIGH" \| "MEDIUM" \| "LOW"` | Yes | — | Confidence in the legal entity info. Allowed: `HIGH`, `MEDIUM`, `LOW`. |
| `result.data.record.legal_info.legal_name` | `string \| null` | Yes | — | Registered legal name. |
| `result.data.record.legal_info.website` | `string \| null` | Yes | — | Official URL of the legal entity. |
| `result.data.record.trading_info` | `object` | Yes | — | — |
| `result.data.record.trading_info.country` | `string \| null` | Yes | — | Country of the trading entity's operational region. |
| `result.data.record.trading_info.website` | `string \| null` | Yes | — | Primary trading website URL. |
| `result.data.record.trading_info.reasoning` | `string` | Yes | — | Explanation of how the trading identity was identified. |
| `result.data.record.trading_info.trading_name` | `string \| null` | Yes | — | Primary trading name. |
| `result.data.record.trading_info.confidence` | `"HIGH" \| "MEDIUM" \| "LOW"` | Yes | — | Confidence in the trading identity info. Allowed: `HIGH`, `MEDIUM`, `LOW`. |
| `result.data.record.entity_classification` | `object \| null` | No | — | Classification of the resolved entity by industry/domain. Null when classification is unavailable. |
| `result.data.record.entity_classification.type` | `string` | Yes | — | Entity category. One of: Company, Government, Education. |
| `result.data.record.entity_classification.subtype` | `string` | Yes | — | Entity sub-category. E.g. Operating, HoldCo/Investment, Business Unit, Establishment. |
| `result.data.record.entity_classification.reasoning` | `string \| null` | No | — | Explanation of the classification. |
| `result.data.record.linkedin` | `object \| null` | No | — | LinkedIn company profile match. Only present when `match_to_linkedin` was set to `true` in the request. |
| `result.data.record.linkedin.url` | `string \| null` | No | — | Full LinkedIn company profile URL. |
| `result.data.record.linkedin.slug` | `string \| null` | No | — | Company slug extracted from the LinkedIn URL. |
| `result.data.record.linkedin.match_type` | `"actual" \| "indicative" \| "none"` | No | — | How the LinkedIn profile was matched. `actual` is a verified direct match. `indicative` is a best-guess match. `none` when no match was found. Allowed: `actual`, `indicative`, `none`. |
| `result.data.record.linkedin.reasoning` | `string \| null` | No | — | Explanation of how the LinkedIn match was determined. |
| `result.data.record.external_id` | `string` | No | — | 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. |
| `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). |

<details>
  <summary>Show raw output schema</summary>

  ### 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",
                  "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
  }
  ```
</details>

## 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.