Skip to main content
GET
Get Run
Poll this endpoint to check whether a pipeline run has completed. When status is COMPLETED, the result field contains the output data. This endpoint works for any pipeline type (hiring signals, enrichment, etc.). The run_id is returned when you trigger a pipeline (e.g., from find leavers).
Poll every 10 seconds for small runs. For larger runs, poll every 30 seconds. Most runs complete within 30-90 seconds depending on the pipeline and data volume.

Example responses

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

run_id
string
required

Response

Successful Response

run_id
string
required

The unique identifier for this run.

status
string
required

Current status: QUEUED, RUNNING, COMPLETED, or FAILED.

result
any | null

Pipeline output. Structure varies by endpoint. null while in progress.

started_at
string | null

ISO 8601 timestamp when the run started.

finished_at
string | null

ISO 8601 timestamp when the run completed. null while in progress.