get_findings

Retrieve the findings from a completed audit with optional filtering by severity, rule, or status.

Description

The get_findings tool returns the full list of findings from a completed audit. Use filtering parameters to narrow down results by severity, rule ID, or finding status.

Parameters

Parameter	Type	Required	Description
audit_id	`string`	required	Audit ID from audit_url response
severity	`'critical' \| 'serious' \| 'moderate' \| 'minor'`	optional	Filter by severity level
rule_id	`string`	optional	Filter by specific rule ID (e.g., "color-contrast")
status	`'open' \| 'fixed' \| 'ignored'`	optional	Filter by finding status
limit	`number`	optional	Maximum number of findings to return. Default: 50
offset	`number`	optional	Skip this many findings (for pagination). Default: 0

Response

Returns an array of finding objects:

type

itemsobject

idstring

Unique finding identifier

Example: "fnd_xyz789"

rule_idstring

Rule that triggered this finding

Example: "color-contrast"

severitystring

Severity level

Example: "serious"

messagestring

Human-readable description

Example: "Text has insufficient color contrast ratio"

elementobject

Element information

selectorstring

CSS selector

Example: ".hero-text"

htmlstring

HTML snippet

Example: "<p class=\"hero-text\">Welcome</p>"

bounding_boxobject

Element position

wcagstring

Related WCAG criterion

Example: "1.4.3"

statusstring

Finding status

Example: "open"

Example Conversations

Get All Findings

"Show me all findings from audit aud_abc123"

get_findings({
  audit_id: "aud_abc123"
})

Filter by Severity

"Get all critical findings from the last audit"

get_findings({
  audit_id: "aud_abc123",
  severity: "critical"
})

Filter by Rule

"Show me all color contrast issues"

get_findings({
  audit_id: "aud_abc123",
  rule_id: "color-contrast"
})

Paginated Results

"Get the next 10 findings after the first 50"

get_findings({
  audit_id: "aud_abc123",
  limit: 10,
  offset: 50
})

Common Rule IDs

Rule ID	Description	Severity
`color-contrast`	Insufficient text contrast	serious
`image-alt`	Missing alt text	critical
`button-name`	Button lacks accessible name	critical
`link-name`	Link lacks accessible name	serious
`label`	Form input missing label	critical
`heading-order`	Incorrect heading hierarchy	moderate
`focus-visible`	Missing focus indicator	serious
`keyboard`	Not keyboard accessible	critical

Workflow Example

Typical flow after getting findings:

1. audit_url → Get audit_id
2. get_findings (severity: critical) → Review critical issues
3. explain_finding → Understand specific issue
4. suggest_fix → Get code to fix it

Error Handling

Error	Cause	Solution
`AUDIT_NOT_FOUND`	Invalid audit_id	Verify audit_id from audit_url response
`AUDIT_NOT_COMPLETE`	Audit still running	Wait for audit to complete or check status
`INVALID_FILTER`	Invalid filter value	Check severity/status enum values

audit_url - Run an audit to get findings
explain_finding - Understand a specific finding
suggest_fix - Get fix for a finding

Was this page helpful?

get_findings

On this page