Skip to main content
GET
/
projects
/
{projectId}
/
audits
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "2e8b1269-d954-4b3b-a5e5-233bd44dfc28",
      "target_url": "https://siouxcitytreeco.com/",
      "status": "completed",
      "crawl_progress": 100,
      "pages_crawled": 34,
      "total_issues": 0,
      "critical_issues": 0,
      "warning_issues": 0,
      "notice_issues": 0,
      "started_at": "2026-05-03T20:06:21.861+00:00",
      "completed_at": "2026-05-03T21:04:36.6+00:00",
      "created_at": "2026-05-03T20:06:21.998Z"
    }
  ]
}
Returns audit tasks ordered by most recent first.

Path parameters

projectId
string
required
Project UUID

Query parameters

limit
number
default:"50"
Max audits to return
offset
number
default:"0"
Number to skip
status
string
Filter by status: pending, crawling, processing, completed, failed
curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "2e8b1269-d954-4b3b-a5e5-233bd44dfc28",
      "target_url": "https://siouxcitytreeco.com/",
      "status": "completed",
      "crawl_progress": 100,
      "pages_crawled": 34,
      "total_issues": 0,
      "critical_issues": 0,
      "warning_issues": 0,
      "notice_issues": 0,
      "started_at": "2026-05-03T20:06:21.861+00:00",
      "completed_at": "2026-05-03T21:04:36.6+00:00",
      "created_at": "2026-05-03T20:06:21.998Z"
    }
  ]
}