> ## 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.

# List Audits

> List site audit tasks for a project

Returns audit tasks ordered by most recent first.

### Path parameters

<ParamField path="projectId" type="string" required>Project UUID</ParamField>

### Query parameters

<ParamField query="limit" type="number" default="50">Max audits to return</ParamField>
<ParamField query="offset" type="number" default="0">Number to skip</ParamField>
<ParamField query="status" type="string">Filter by status: `pending`, `crawling`, `processing`, `completed`, `failed`</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.ranked.ai/api/v1/projects/{projectId}/audits" \
    -H "Authorization: Bearer rk_live_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>