Get resolve parent result

GET

resolve-parent

{job_id}

curl --request GET \
  --url https://api.kernel.ai/rest/v1/resolve-parent/{job_id} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.kernel.ai/rest/v1/resolve-parent/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.kernel.ai/rest/v1/resolve-parent/{job_id}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kernel.ai/rest/v1/resolve-parent/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "reasoning": "Google LLC is a wholly-owned subsidiary of Alphabet Inc., its parent holding company.",
      "confidence": "HIGH"
    },
    "top_parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "reasoning": "Alphabet Inc. is the ultimate parent in the corporate hierarchy, with no parent of its own.",
      "confidence": "HIGH"
    },
    "regional_subsidiary": {
      "is_regional": false,
      "regional_scope": null,
      "reasoning": null
    }
  }
}

Poll this endpoint to check the status and retrieve the result of a parent hierarchy resolution job.

Status lifecycle

Jobs progress linearly to a terminal state:

pending → processing → completed | failed

Once a job reaches completed or failed, the status does not change.

Result structure

When status is completed, the record field contains the parent hierarchy data with parent, top_parent, top_operating_parent (conditionally present), and regional_subsidiary. For pending or processing jobs, only status is returned. For failed jobs, record is absent and error_message with error_type are present instead.

Example

curl

curl https://api.kernel.ai/rest/v1/resolve-parent/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: $KERNEL_API_KEY"

Response (200) — completed, parent found

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "reasoning": "Google LLC is a wholly-owned subsidiary of Alphabet Inc., its parent holding company.",
      "confidence": "HIGH"
    },
    "top_parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "confidence": "HIGH"
    },
    "top_operating_parent": {
      "kernel_id": "6347422643",
      "trading_name": "Google",
      "legal_name": "Google LLC",
      "website": "https://google.com",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "Operating",
      "confidence": "HIGH"
    },
    "regional_subsidiary": {
      "is_regional": false,
      "regional_scope": null,
      "reasoning": null
    }
  }
}

Response (200) — completed, no parent (standalone entity)

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "parent": null,
    "top_parent": {
      "kernel_id": "6347422643",
      "trading_name": "Stripe",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "Operating",
      "confidence": null
    },
    "top_operating_parent": {
      "kernel_id": "6347422643",
      "trading_name": "Stripe",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "Operating",
      "confidence": null
    },
    "regional_subsidiary": {
      "is_regional": false,
      "regional_scope": null,
      "reasoning": null
    }
  }
}

Response (200) — pending

{
  "status": "pending"
}

Response (200) — failed

{
  "jobid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "failed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "error_message": "Entity not found",
  "error_type": "kernel_id_not_found"
}

Response fields

`record.parent`

object | null — The immediate parent entity. null when the entity has no parent (standalone).

Field	Type	Description
`kernel_id`	`string`	Kernel ID of the parent entity
`trading_name`	`string \| null`	Parent trading name
`legal_name`	`string \| null`	Parent registered legal name
`website`	`string \| null`	Parent company website URL
`country`	`string \| null`	Parent country (ISO 3166-1 alpha-2 or full name)
`entity_category`	`string \| null`	Parent entity category. One of: `Company`, `Government`, `Education`
`entity_sub_category`	`string \| null`	Parent entity sub-category. One of: `Operating`, `HoldCo/Investment`, `Business Unit`, `Establishment`
`reasoning`	`string \| null`	Explanation of why this entity was identified as the parent
`confidence`	`string \| null`	Confidence in the parent identification. One of: `HIGH`, `MEDIUM`, `LOW`

`record.top_parent`

object | null — 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. Has the same fields as parent except it does not include reasoning (only confidence).

`record.top_operating_parent`

object | null — The topmost operating company (excluding HoldCo/investment vehicles) found by looking up the corporate hierarchy from the queried entity. This field is conditionally present:

Present when the entity is an operating company or when an operating company is found above it in the hierarchy
Omitted for standalone entities that are not operating companies (e.g. HoldCos with no tree)

When present, the value is null if no operating company exists in the upward chain (e.g. a HoldCo whose entire parent chain consists of other HoldCos). Has the same fields as top_parent (no reasoning, includes confidence).

`record.regional_subsidiary`

object — Whether the queried entity operates as a regional subsidiary of its parent.

Field	Type	Description
`is_regional`	`boolean \| null`	`true` if the entity is a regional subsidiary, `false` if not. `null` when not yet determined.
`regional_scope`	`string \| null`	The country scope of the regional operation (e.g. `"United States"`, `"India"`). `null` when not a regional subsidiary or not yet determined.
`reasoning`	`string \| null`	Explanation of the regional subsidiary classification

Polling guidance

Use exponential backoff between polls (start at 2 seconds, cap at 30 seconds).
Jobs that do not exist yet (or whose ID is unknown) return { "status": "pending" }.

Resolve parent — Start a parent hierarchy resolution job

Authorizations

x-api-key

string

header

required

Include your API key in the x-api-key header.

Path Parameters

job_id

string

required

Job ID returned by the POST endpoint

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Response

Job status response

status

enum<string>

required

Current status of the job. Terminal states are completed and failed.

Available options:

pending,

processing,

completed,

failed

string

Unique identifier for the job. Present when status is pending, processing, or completed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

jobid

string

Unique identifier for the job. Present only when status is failed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

created_at

string<date-time>

ISO 8601 timestamp when the job was created.

Example:

"2025-06-05T12:00:00Z"

completed_at

string<date-time>

ISO 8601 timestamp when the job reached a terminal state.

Example:

"2025-06-05T12:00:05Z"

record

object

Parent hierarchy data. Present when status is completed.

Show child attributes

error_message

string

Error message. Present when status is failed.

error_type

string

Machine-readable error type. Present when status is failed. One of: kernel_id_not_found, unknown.

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

Get resolve parent result

curl --request GET \
  --url https://api.kernel.ai/rest/v1/resolve-parent/{job_id} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.kernel.ai/rest/v1/resolve-parent/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.kernel.ai/rest/v1/resolve-parent/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.kernel.ai/rest/v1/resolve-parent/{job_id}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kernel.ai/rest/v1/resolve-parent/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "created_at": "2025-06-05T12:00:00Z",
  "completed_at": "2025-06-05T12:00:05Z",
  "record": {
    "kernel_id": "6347422643",
    "parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "reasoning": "Google LLC is a wholly-owned subsidiary of Alphabet Inc., its parent holding company.",
      "confidence": "HIGH"
    },
    "top_parent": {
      "kernel_id": "7944166432",
      "trading_name": "Alphabet Inc.",
      "legal_name": "Alphabet Inc.",
      "website": "https://abc.xyz",
      "country": "US",
      "entity_category": "Company",
      "entity_sub_category": "HoldCo/Investment",
      "reasoning": "Alphabet Inc. is the ultimate parent in the corporate hierarchy, with no parent of its own.",
      "confidence": "HIGH"
    },
    "regional_subsidiary": {
      "is_regional": false,
      "regional_scope": null,
      "reasoning": null
    }
  }
}

Getting started

API reference

API keys & Webhooks

Get resolve parent result

Status lifecycle

Result structure

Example

Response fields

`record.parent`

`record.top_parent`

`record.top_operating_parent`

`record.regional_subsidiary`

Polling guidance

Authorizations

Path Parameters

Response

​Status lifecycle

​Result structure

​Example

​Response fields

​record.parent

​record.top_parent

​record.top_operating_parent

​record.regional_subsidiary

​Polling guidance

​Related endpoints

Authorizations

Path Parameters

Response

Status lifecycle

Result structure

Example

Response fields

`record.parent`

`record.top_parent`

`record.top_operating_parent`

`record.regional_subsidiary`

Polling guidance

Related endpoints