Skip to main content
GET
/
projects
/
{projectId}
/
audits
/
{auditId}
/
issues
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits/{auditId}/issues?severity=critical" \
  -H "Authorization: Bearer rk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "a27fd070-0b6f-47bf-8efe-2b130db0111d",
      "type": "no_h1_tag",
      "severity": "critical",
      "title": "Missing H1 Tags",
      "description": "Pages without H1 tags",
      "affected_count": 3,
      "status": "failed",
      "created_at": "2026-05-03T21:04:36.6+00:00"
    }
  ],
  "meta": {
    "pagination": { "total": 11, "limit": 50, "offset": 0, "has_more": false }
  }
}

Documentation Index

Fetch the complete documentation index at: https://dev.ranked.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns audit issues sorted by severity (critical, warning, notice) then by affected count.

​
Path parameters

​
projectId
string
required
Project UUID
​
auditId
string
required
Audit task UUID

​
Query parameters

​
limit
number
default:"50"
Max issues to return
​
offset
number
default:"0"
Number to skip
​
severity
string
Filter: critical, warning, or notice
​
status
string
Filter: passed or failed
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits/{auditId}/issues?severity=critical" \
  -H "Authorization: Bearer rk_live_your_api_key"

{
  "success": true,
  "data": [
    {
      "id": "a27fd070-0b6f-47bf-8efe-2b130db0111d",
      "type": "no_h1_tag",
      "severity": "critical",
      "title": "Missing H1 Tags",
      "description": "Pages without H1 tags",
      "affected_count": 3,
      "status": "failed",
      "created_at": "2026-05-03T21:04:36.6+00:00"
    }
  ],
  "meta": {
    "pagination": { "total": 11, "limit": 50, "offset": 0, "has_more": false }
  }
}