Jobs
List Jobs
List import and account research jobs with optional status filter
GET
List import and account research jobs, optionally filtered by status.
A
FAILED job carries failure_reason, a plain-English sentence saying why and what to do, and
reason_code, a stable code. See Get Job Status for the codes.
Each job also carries overlaps_pending: true while a finished job still has warm-intro overlaps
being worked out in the background, so its opportunity count can still grow. See
Get Job Status.
A COMPLETED import whose warm-intro derivation did not finish inside the run carries
derive_incomplete: true, derive_incomplete_reason and derive_note. See
Get Job Status.
A job may come back with QUEUED if your workspace already had imports in progress when it was
submitted. It starts automatically once capacity frees up, no action needed.
Authorizations
The API key you created on the API settings page of the Clustr app.
Query Parameters
Keep jobs with these statuses: QUEUED, PROCESSING, COMPLETED, FAILED or CANCELLED. Send a comma-separated list for several.
The maximum number of jobs to return. Defaults to 100, up to 1000.
The number of jobs to skip, for offset pagination.
The page to return, as an alternative to offset. Sending page or page_size uses them in place of limit and offset.
Required range:
x >= 1Jobs per page when paging with page. Defaults to 25, up to 100.
Required range:
1 <= x <= 100