icp. job_ status
Check the progress of an ICP search and retrieve its results.
0 credits. Free: status read.
Example prompt
Send this to your AI app when Heelo is connected:
Check on my ICP search
Input fields
| Field | Type | Description |
|---|---|---|
job_idRequired | string | The job_id returned by icp.search |
limit | integer | Max companies to return (default 100) |
offset | integer | Pagination offset into the ranked list |
include_claims | boolean | Include the full per-field provenance for each company. Verbose — use only when auditing where a value came from. |
Output fields
The fields in data when status is success.
| Field | Type | Description |
|---|---|---|
answer | string | |
duration_s | number | |
job_id | string | |
status | string | |
phase | string | |
phase_label | string | |
progress | object | The counts of the run. `sources_read` is the number of discovery sources that the job tried. When the job has finished, `errors` holds a count per error code for what failed without failing the job: one final code per discovery source (none if a read found companies, so a source that only the browser could read has none), one per company that could not be read, and one if the web search could not run. For example, `source_unavailable` counts a company's site or a source that could not be read, and a source that lost its browser render and kept what plain HTTP found. |
cost_cents | integer | |
companies | array of object | The companies, best first (for small local businesses, the ones with an address come first). Each has: name, domain, rank, contact_name, contact_position, persona_match, contact, geography, employee_number, size_confirmed, company_type, funding_stage, recent_funding, valuation, found_via, fit_score, status. size_confirmed is null when the search asked for no size range, false when the headcount is unknown, unparseable or only a team-page count, and true when a stated count or band backs it. persona_match is true when the contact's title holds one of the spec's contact_titles (read by a reranker), false for a fallback such as a founder or CEO, and null when there is no contact, no title was asked for, the reranker failed, or the title matches but the employer check gave no answer for it (unknown). |
complete | boolean | |
ranking_final | boolean | |
estimate | object | |
retry_after_s | integer | |
next_action | string | |
error | string |
Code
The call with the input fields that the tool needs. Replace each word in capitals, such as JOB_ID. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/icp.job_status/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"job_id": "JOB_ID",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/icp.job_status/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"job_id": "JOB_ID"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());