List Audits

List site audit tasks for a project

GEThttps://app.ranked.ai/api/v1/projects/{projectId}/audits

Returns audit tasks ordered by most recent first.

Path parameters

projectIdstringrequired
Project UUID

Query parameters

limitnumberdefault: 50
Max audits to return
offsetnumberdefault: 0
Number to skip
statusstring
Filter by status: pending, crawling, processing, completed, failed

Request

curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
  -H "Authorization: Bearer rk_live_your_api_key"

Response

{
  "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"
    }
  ]
}

This page is also available as markdown for AI agents, and the whole reference as an OpenAPI spec. Questions? Developer support.