> ## 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 Combined > Starting entity resolution with parentage, firmographics, or both. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost. Starting entity resolution with parentage, firmographics, or both. Tool ID: `kernel_combined` ## Run this action Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV. ```ts theme={null} import { Deepline } from 'deepline'; const deepline = await Deepline.connect(); const result = await deepline.tools.execute( 'kernel_combined', { "jobs": [ "firmographics" ] }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute kernel_combined --input '{ "jobs": [ "firmographics" ] }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "data": { "id": "id_123", "status": "processing" } } ``` Use `deepline tools get kernel_combined --json` for the latest machine-readable contract. ## Input reference Starts an entity resolution job and then runs one or more follow-up enrichments. Returns immediately with an `id` — poll `GET /v1/combined/{job_id}` until the status is `completed`. When both follow-ups are requested, they run in parallel after entity resolution completes. | Name | Type | Required | Default | Details | | --------------------------- | --------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `payload.legal_name` | `string` | No | — | Registered legal name of the company (e.g. "Stripe, Inc.") Minimum length: 1. | | `payload.trading_name` | `string` | No | — | Primary brand or trading name (e.g. "Stripe") Minimum length: 1. | | `payload.website` | `string` | No | — | Company website URL. Minimum length: 1. | | `payload.country` | `string` | No | — | Country name or ISO 3166-1 alpha-2 code. Minimum length: 1. | | `payload.city` | `string` | No | — | City. Minimum length: 1. | | `payload.state` | `string` | No | — | State or province. Minimum length: 1. | | `payload.postal_code` | `string` | No | — | ZIP or postal code. Minimum length: 1. | | `payload.address` | `string` | No | — | Street address. Minimum length: 1. | | `payload.email` | `string` | No | — | Email address. Only the domain portion is used for matching. Minimum length: 1. | | `payload.phone` | `string` | No | — | Phone number. Used as an additional signal for entity resolution. Minimum length: 1. | | `payload.external_id` | `string` | No | — | Your own identifier for this record. Minimum length: 1. | | `payload.kernel_id` | `string` | No | — | An existing Kernel ID. When provided, the resolver skips matching and returns the canonical record for this entity. Minimum length: 1. | | `payload.linkedin_url` | `string` | No | — | LinkedIn URL for the company (e.g. "[https://linkedin.com/company/stripe](https://linkedin.com/company/stripe)"). Used as an additional signal for entity resolution. Minimum length: 1. | | `payload.match_to_linkedin` | `boolean` | No | `false` | When `true`, Kernel will attempt to match the resolved entity to a LinkedIn company profile. The result is returned in the `linkedin` field of the completed record. Defaults to `false`. | | `payload.identity_bias` | `"NAME_BIAS" \| "URL_BIAS"` | No | — | Bias the resolver toward name or URL matching when they conflict. One of: `NAME_BIAS`, `URL_BIAS`. Defaults to `URL_BIAS`. Allowed: `NAME_BIAS`, `URL_BIAS`. | | `payload.jobs` | `array` | Yes | — | Follow-up enrichment jobs to run after entity resolution. Minimum items: 1. Items must be unique. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "Starts an entity resolution job and then runs one or more follow-up enrichments. Returns immediately with an `id` — poll `GET /v1/combined/{job_id}` until the status is `completed`. When both follow-ups are requested, they run in parallel after entity resolution completes.", "properties": { "legal_name": { "type": "string", "description": "Registered legal name of the company (e.g. \"Stripe, Inc.\")", "minLength": 1 }, "trading_name": { "type": "string", "description": "Primary brand or trading name (e.g. \"Stripe\")", "minLength": 1 }, "website": { "type": "string", "description": "Company website URL.", "minLength": 1 }, "country": { "type": "string", "description": "Country name or ISO 3166-1 alpha-2 code.", "minLength": 1 }, "city": { "type": "string", "description": "City.", "minLength": 1 }, "state": { "type": "string", "description": "State or province.", "minLength": 1 }, "postal_code": { "type": "string", "description": "ZIP or postal code.", "minLength": 1 }, "address": { "type": "string", "description": "Street address.", "minLength": 1 }, "email": { "type": "string", "description": "Email address. Only the domain portion is used for matching.", "minLength": 1 }, "phone": { "type": "string", "description": "Phone number. Used as an additional signal for entity resolution.", "minLength": 1 }, "external_id": { "type": "string", "description": "Your own identifier for this record.", "minLength": 1 }, "kernel_id": { "type": "string", "description": "An existing Kernel ID. When provided, the resolver skips matching and returns the canonical record for this entity.", "minLength": 1 }, "linkedin_url": { "type": "string", "description": "LinkedIn URL for the company (e.g. \"https://linkedin.com/company/stripe\"). Used as an additional signal for entity resolution.", "minLength": 1 }, "match_to_linkedin": { "type": "boolean", "description": "When `true`, Kernel will attempt to match the resolved entity to a LinkedIn company profile. The result is returned in the `linkedin` field of the completed record. Defaults to `false`.", "default": false }, "identity_bias": { "type": "string", "description": "Bias the resolver toward name or URL matching when they conflict. One of: `NAME_BIAS`, `URL_BIAS`. Defaults to `URL_BIAS`.", "enum": [ "NAME_BIAS", "URL_BIAS" ] }, "jobs": { "type": "array", "description": "Follow-up enrichment jobs to run after entity resolution.", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "firmographics", "resolve-parent" ] } } }, "required": [ "jobs" ], "additionalProperties": false } ```
## Output reference Standard tool result payload. | Name | Type | Required | Default | Details | | -------------------- | -------------- | -------- | ------- | ------------------------------------------------- | | `result.data` | `object` | Yes | — | Provider response payload. | | `result.data.id` | `string` | Yes | — | Unique identifier for the created job. | | `result.data.status` | `"processing"` | Yes | — | Initial status of the job. Allowed: `processing`. | | `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 created job." }, "status": { "type": "string", "description": "Initial status of the job.", "enum": [ "processing" ] } }, "required": [ "id", "status" ], "additionalProperties": false }, "meta": { "type": "object", "description": "Additional response metadata (status, paging).", "additionalProperties": true } }, "required": [ "data" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `per_result` (per result). * Estimated Deepline credits: `4.2` per pricing unit. ## Related documentation * [Kernel.ai provider guide](/docs/providers/kernel/guide) * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)