API reference
Get a scan
Poll a scan until its status is completed (or failed). Once complete, the summary carries the score and grade; fetch the full report separately.
GET
/v1/scans/{id}Path parameters
| Field | Type | Status | Description |
|---|---|---|---|
| id | string | required | The scan id returned by POST /v1/scans. |
Response
| Field | Type | Description |
|---|---|---|
| id | string | The scan id. |
| status | string | queued · running · completed · failed. |
| overall_score | number | null | 0–100, present once completed. |
| grade | string | null | A–F, present once completed. |
| pages_scanned | number | null | How many pages were crawled. |
| started_at / completed_at | string | null | ISO 8601 timestamps. |
json
{
"id": "scan_8fk2…",
"status": "completed",
"overall_score": 72,
"grade": "C",
"pages_scanned": 17,
"started_at": "2026-06-10T15:01:22Z",
"completed_at": "2026-06-10T15:03:05Z"
}Examples
curl -s https://api.sifthealth.app/v1/scans/scan_8fk2 \
-H "Authorization: Bearer $SIFT_API_KEY"