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

Query parameters

Parameter	Type	Default	Description
limit	number	25	Page size, 1–100.
offset	number	0	Rows to skip.

Example

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 }
}

Response fields

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.

Errors

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.