Get combined result

GET

combined

{job_id}

Get combined result

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

import requests

url = "https://api.kernel.ai/rest/v1/combined/{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/combined/{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/combined/{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/combined/{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/combined/{job_id}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kernel.ai/rest/v1/combined/{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",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "city": "South San Francisco",
          "country": "US"
        }
      },
      "headcount": {
        "count": 7000
      },
      "revenue": {
        "usd": 1000000000
      }
    }
  }
}

Returns the status and result of a combined job started with POST /v1/combined. When status is completed, the record field contains:

The entity resolution result (kernel_id, identity_resolution_*, legal_info, trading_info, entity_classification, and optionally linkedin)
The follow-up enrichment result under firmographics or parentage, depending on the jobs value submitted
Your external_id, echoed back on record.external_id, if you included one in the request

If entity resolution does not find a match, the job still completes: record.kernel_id is null, the identity detail fields and any requested follow-up fields are null, and identity_resolution_confidence and identity_resolution_reasoning explain the resolution attempt. See No match.

Processing response

While the combined job is running, the response includes a subprocesses object showing the status of each step:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "created_at": "2025-06-05T12:00:00Z",
  "subprocesses": {
    "entity-resolution": "completed",
    "resolve-parent": "processing",
    "firmographics": "pending"
  }
}

Each subprocess follows the same pending → processing → completed | failed lifecycle. Poll until the top-level status is completed or failed.

Completed response examples

With firmographics

{
  "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",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "city": "South San Francisco",
          "country": "US"
        }
      },
      "headcount": {
        "count": 7000
      },
      "revenue": {
        "usd": 1000000000
      }
    },
    "external_id": "stripe-001"
  }
}

With parentage

{
  "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",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "parentage": {
      "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
      }
    }
  }
}

With firmographics and parentage

{
  "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",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "street": null,
          "city": "South San Francisco",
          "state": "California",
          "country": "United States",
          "postcode": "94080",
          "reasoning": "Address derived from company registration records."
        },
        "registered": {
          "street": "354 Oyster Point Blvd",
          "city": "South San Francisco",
          "state": "California",
          "country": "United States",
          "postcode": "94080",
          "reasoning": "Address from official registry filing."
        }
      },
      "headcount": {
        "count": 7000,
        "count_entity": 7000,
        "count_consolidated": 7000,
        "confidence": "HIGH",
        "reasoning": "Headcount derived from annual report figures."
      },
      "revenue": {
        "usd": 1000000000,
        "usd_entity": 1000000000,
        "consolidated_usd": 1000000000,
        "confidence": "HIGH",
        "local_currency": "USD",
        "local_currency_entity": "USD",
        "local": 1000000000,
        "local_entity": 1000000000,
        "consolidated_local": 1000000000,
        "consolidated_currency": "USD",
        "reasoning": "Revenue sourced from audited annual financial statements.",
        "source": "identified"
      }
    },
    "parentage": {
      "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
      }
    }
  }
}

No match

If entity resolution does not find a match, the follow-up credits are refunded, the follow-up jobs are skipped, and the job completes with kernel_id: null. The requested follow-up fields (firmographics, parentage) are returned as null, along with linkedin if match_to_linkedin was requested. identity_resolution_confidence and identity_resolution_reasoning remain populated to explain the resolution attempt:

{
  "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": null,
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Company identified as Acme Inc. via legal name and website alignment, but no matching entity exists in Kernel's database.",
    "legal_info": null,
    "trading_info": null,
    "entity_classification": null,
    "firmographics": null,
    "parentage": null
  }
}

Failed response

If the job fails for another reason, the response uses jobid instead of id and includes error_message and error_type:

{
  "jobid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "failed",
  "error_message": "Job failed",
  "error_type": "unknown"
}

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

Combined entity resolution and enrichment result. 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.

Get credits

Get combined result

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

import requests

url = "https://api.kernel.ai/rest/v1/combined/{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/combined/{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/combined/{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/combined/{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/combined/{job_id}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kernel.ai/rest/v1/combined/{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",
    "identity_type": "legal_entity",
    "identity_resolution_confidence": "HIGH",
    "identity_resolution_reasoning": "Matched by domain and legal name.",
    "legal_info": {
      "country": "US",
      "reasoning": "Confirmed via Stripe terms of service page.",
      "trading_name": "Stripe, Inc.",
      "confidence": "HIGH",
      "legal_name": "Stripe, Inc.",
      "website": "https://stripe.com"
    },
    "trading_info": {
      "country": "US",
      "website": "https://stripe.com",
      "reasoning": "Primary brand site confirmed via domain ownership.",
      "trading_name": "Stripe",
      "confidence": "HIGH"
    },
    "entity_classification": {
      "type": "Company",
      "subtype": "Operating",
      "reasoning": "Classified as an operating company based on commercial activity."
    },
    "firmographics": {
      "kernel_id": "6347422643",
      "op_status": {
        "operational_status": "Active",
        "reasoning": "Website is live."
      },
      "location": {
        "operating": {
          "city": "South San Francisco",
          "country": "US"
        }
      },
      "headcount": {
        "count": 7000
      },
      "revenue": {
        "usd": 1000000000
      }
    }
  }
}

Getting started

API reference

API keys & Webhooks

Get combined result

Processing response

Completed response examples

With firmographics

With parentage

With firmographics and parentage

No match

Failed response

Authorizations

Path Parameters

Response

​Processing response

​Completed response examples

​With firmographics

​With parentage

​With firmographics and parentage

​No match

​Failed response

Authorizations

Path Parameters

Response

Processing response

Completed response examples

With firmographics

With parentage

With firmographics and parentage

No match

Failed response