Skip to main content
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

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Query Parameters

status
string

Keep jobs with these statuses: QUEUED, PROCESSING, COMPLETED, FAILED or CANCELLED. Send a comma-separated list for several.

limit
integer
default:100

The maximum number of jobs to return. Defaults to 100, up to 1000.

offset
integer
default:0

The number of jobs to skip, for offset pagination.

page
integer

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 >= 1
page_size
integer
default:25

Jobs per page when paging with page. Defaults to 25, up to 100.

Required range: 1 <= x <= 100

Response

List of jobs

success
boolean
required
data
object
required