Skip to main content
GET
/
scans
/
{id}
/
status
Get scan status
curl --request GET \
  --url https://api.example.com/scans/{id}/status
Returns a minimal payload with the scan’s current status. Use this for polling; the response omits the findings summary that GET /scans/{id} computes.
Scope required: read

​
Request

curl "https://api.hacktron.ai/v1/scans/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status" \
  -H "X-Api-Key: $HACKTRON_API_KEY"

​
Path parameters

ParameterTypeDescription
idUUIDScan UUID.

​
Response

200 OK 
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "task_id": "web_scan_1712345678",
  "status": "running",
  "created_at": "2026-04-13T12:00:00.000Z",
  "updated_at": "2026-04-13T12:18:04.000Z"
}
See List scans for the full list of status values. A poll interval of 10–30 seconds is sufficient. Pentest scans complete on the order of minutes; tighter polling provides no additional signal and consumes the rate limit quota. Stop polling when status reaches a terminal value: completed, failed, stopped, cancelled, or skipped.

​
Errors

  • 404 — scan not found or not visible to your organization.