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	Definite failures found across all pages.
incompleteCount	number	Checks needing human review.
passCount	number	Checks that passed.
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.