# Audit Issues

Source: https://www.ranked.ai/developers/api-reference/audits/issues

`GET https://app.ranked.ai/api/v1/projects/{projectId}/audits/{auditId}/issues`

> Get issues for a specific audit sorted by severity

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

### Path parameters

- `projectId` (path, string, required): Project UUID
- `auditId` (path, string, required): Audit task UUID

### Query parameters

- `limit` (query, number, default 50): Max issues to return
- `offset` (query, number, default 0): Number to skip
- `severity` (query, string): Filter: `critical`, `warning`, or `notice`
- `status` (query, string): Filter: `passed` or `failed`

**Request**

```bash cURL
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits/{auditId}/issues?severity=critical" \
  -H "Authorization: Bearer rk_live_your_api_key"
```

**Response**

```json 200
{
  "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 }
  }
}
```