Skip to main content
GET
/
api
/
v1
/
scan
/
status
/
{scan_id}
Scan Job Status
curl --request GET \
  --url http://localhost:8000/api/v1/scan/status/{scan_id}
{
  "scan_id": "<string>",
  "status": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>",
  "error": "<string>",
  "stored_scan_id": "<string>"
}

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.

Polls the in-memory job table populated by /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}