# List Audits

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

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

> List site audit tasks for a project

Returns audit tasks ordered by most recent first.

### Path parameters

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

### Query parameters

- `limit` (query, number, default 50): Max audits to return
- `offset` (query, number, default 0): Number to skip
- `status` (query, string): Filter by status: `pending`, `crawling`, `processing`, `completed`, `failed`

**Request**

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

**Response**

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