---
title: "Ada Audit"
method: GET
path: "/audit/accessibility"
---

# Ada Audit

`GET /audit/accessibility`

## Request

- Base URL: `https://seoscoreapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://seoscoreapi.com/audit/accessibility`
- Auth: none declared. Required headers: `X-API-Key`

Run an ADA / WCAG 2.1 AA accessibility compliance audit. Paid plans only.

Returns a detailed accessibility report including:
- Overall compliance score and grade (WCAG 2.1 A/AA rules only)
- Lawsuit risk assessment (high/medium/low/minimal)
- Category breakdowns (images, forms, contrast, keyboard, ARIA, etc.)
- `violations`: WCAG 2.1 AA failures, with affected elements and a plain-English fix
- `best_practices`: axe best-practice findings (e.g. heading-order). Not WCAG
  requirements, so they never lower the score or raise the risk level
- `needs_review`: checks axe couldn't decide automatically, with what to verify by hand.
  They are excluded from the score rather than counted as failures
- `priorities`: WCAG violations first, then best practices. `severity` maps from axe
  `impact` one-to-one: critical→critical, serious→high, moderate→medium, minor→low
  (best practices are always low)

**Limits.** ADA audits have their own monthly allowance (`ada_monthly`: Starter 5,
Basic 20, Pro 100, Ultra 500), separate from your audit quota. Each key may run
20 ADA audits per minute and 2 at a time; the tier `rpm` does not apply here.
`GET /usage` reports `ada_usage_this_month` and `ada_remaining`.
A 429 includes `Retry-After`, and a 429 is never counted against `ada_monthly`
(nor is any failed audit).

**Errors.** A page we can't load returns **422** with `detail` (message) and
`reason`: `blocked` (the site refused our crawler), `timeout`, `dns`, `tls`,
`unreachable`, `not_found`, `http_error`, `non_html`, `redirect_loop`,
`blocked_url`, `load_failed`. A URL we refuse up front (private/internal address,
malformed URL) is **400** with `reason` `blocked_url` / `invalid_url`. A **502**
means the failure was on our side.

Uses the axe-core accessibility engine (industry standard) to check
against WCAG 2.1 Level AA — the standard referenced in most ADA lawsuits.

## Query parameters

- `url` string, required: The URL to audit for ADA/WCAG compliance
- `include` string, nullable: `trackers` adds the tracker and pixel inventory to the report

## Headers

- `X-API-Key` string, required: Your API key

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoscoreapi/apis/seo-score-api.md) · [All operations](https://skmtc.dev/seoscoreapi/apis/seo-score-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seoscoreapi/apis/seo-score-api/revisions/877a3044b5be?raw)