v14

latestOpenAPI 3.0.3Proprietaryraw.githubusercontent.com2026-06-2763565.4 KB

Poll an async job — status + final result

Returns the job's current state. All states (queued, running, succeeded, failed) return 200; 404 for an unknown jobId, 410 once the result has expired (~24h after completion).

On succeeded, result usually carries the per-kind payload inline. When a result is too large to return inline, result is omitted and the response instead carries resultStorage: "s3" plus a short-lived presigned resultUrl (with resultBytes and resultExpiresAt) — fetch that URL directly to download the full payload, and re-poll for a fresh URL if it expires. Recommended polling cadence: every 2–5 seconds. Typical end-to-end run: 5–20 s.

get/intelligence/jobs/{id}

Path parameters

idstring required

Response

Successful response

completedAtnumber

errorstring

jobIdstring required

kind'insights' | 'records' required

resultBytesnumber

Size of the stored result in bytes (present alongside resultUrl).

resultExpiresAtstring

ISO-8601 expiry of resultUrl (clamped to the job's own retention).

resultStorage's3'

Set to "s3" when the result was too large to return inline; in that case result is omitted and resultUrl holds a short-lived presigned download URL instead. Fetch the URL directly; re-poll for a fresh one after it expires (see resultExpiresAt).

resultUrlstring

Short-lived presigned GET URL for a large result (present iff resultStorage === "s3").

startedAtnumber

status'failed' | 'queued' | 'running' | 'succeeded' required

submittedAtnumber required