# Jobs

URL: https://docs.sigment.ai/tools/jobs

Wait for discoveries and analyses to finish.

Paid work runs in the background. `discover_creators`, `analyze_creators` and `run_analysis` return a `job_id`, which is an opaque handle such as `discovery:…`, `snapshot:…/…` or `pipeline:instagram:…`. Pass it unchanged to these tools. A job's `status` is `running`, `completed` or `failed`, and `stage` shows `queued`, `scraping` or `analyzing`. See [Jobs and polling](https://docs.sigment.ai/guides/jobs-and-polling).

### wait_for_job

Block until the job finishes or timeout (max 25s), then return its status. If still running, call again — discoveries take a few minutes, analyses several minutes, longer when queued.

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `job_id` | `string` | yes |  | ≤ 250 chars |
| `timeout_seconds` | `integer` | no | 25 | 1–45 |

### get_job

Status of a job_id from discover_creators / analyze_creators / run_analysis: running | completed | failed (failed paid work is refunded).

Kind: read-only

| Parameter | Type | Required | Default | Limits |
|---|---|---|---|---|
| `job_id` | `string` | yes |  | ≤ 250 chars |