Skip to content

List scans

Returns the site’s scan history, newest first, with the raw counts each scan produced. Useful for trend charts and “when did we last scan?” checks.

GET /api/v1/sites/:siteId/scans
Parameter Type Default Description
limit number 25 Page size, 1–100.
offset number 0 Rows to skip.
Terminal window
curl "https://app.theaccessibility.company/api/v1/sites/site_a1b2c/scans?limit=2" \
-H "Authorization: Bearer tac_mcp_..."
{
"data": [
{
"id": "run_9x8y7",
"status": "completed",
"scopeType": "full_site",
"triggerType": "scheduled",
"totalTargets": 128,
"failedTargets": 1,
"violationCount": 42,
"incompleteCount": 7,
"passCount": 3180,
"startedAtMs": 1746441000000,
"finishedAtMs": 1746442000000,
"createdAtMs": 1746440900000
}
],
"pagination": { "limit": 2, "offset": 0, "total": 57 }
}
Field Type Description
id string Scan run id.
status string queued, running, completed, completed_with_errors, failed, or cancelled.
scopeType string full_site or single_page.
triggerType string manual, scheduled, webhook, api, or verification.
totalTargets number Pages queued for the scan.
failedTargets number Pages that could not be scanned.
violationCount number Individual failing findings (element occurrences) across all pages. A rule failing on 60 elements contributes 60.
incompleteCount number Individual findings needing human review (element occurrences).
passCount number Distinct rules that passed. Different unit from the two counts above: do not combine them into a ratio; a percentage computed as passCount / (passCount + violationCount) is meaningless.
startedAtMs / finishedAtMs number | null Unix ms; null while pending/running.
createdAtMs number When the run was created.
Code When
INVALID_INPUT A query parameter failed validation.
NOT_FOUND The site doesn’t exist in your account.
SITE_SCOPE_MISMATCH The token is locked to a different site.