> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scan Job Status

> Poll for the status of a triggered scan

Polls the in-memory job table populated by [`/scan/trigger`](https://docs.tracectrl.ai/api-reference/scan-trigger). Job entries are pruned 30 minutes after they start; a poll on an expired job returns `404`.

### Path Parameters

**scan\_id** `string` *required*

Job ID returned by `/scan/trigger`.

### Errors

* `404` — Scan job not found (may have expired)

### Response

**scan\_id** `string`

Echo of the requested job ID

**status** `string`

`running`, `complete`, or `failed`

**started\_at** `string`

ISO-8601 timestamp

**completed\_at** `string`

ISO-8601 timestamp once the job has finished, otherwise `null`

**error** `string`

Error message when `status` is `failed`, otherwise `null`

**stored\_scan\_id** `string`

ID of the persisted scan when complete — fetch results via [`/scans/{scan_id}`](https://docs.tracectrl.ai/api-reference/scans-detail)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.