---
title: "List audit runs"
method: GET
path: "/v1/agent-runs"
tags: ["Audits"]
---

# List audit runs

`GET /v1/agent-runs`

## Request

- Base URL: `https://api.squirrelscan.com`
- URL: `https://api.squirrelscan.com/v1/agent-runs`
- Auth: HTTP bearer

List the authenticated user's audit runs, newest first.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'
- `mode` 'audit' | 'audit-fix' | 'fix' | 'recommend'
- `websiteId` string

## Response `200`

Paginated list of audit runs.

- AuditRunList
  - `runs` AuditRunListItem[], required
    - `id` string, required
    - `url` string, uri, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
    - `trigger` 'cli' | 'api' | 'github' | 'scheduled', required
    - `mode` 'audit' | 'audit-fix' | 'fix' | 'recommend', required
    - `model` string, nullable
    - `healthScore` integer, nullable: Rounded score from the persisted `health_score` DB column (an integer). The unrounded float is available as `report.healthScore` on `GET /v1/agent-runs/{id}/report`.
    - `issuesFound` integer, nullable
    - `issuesFixed` integer, nullable
    - `reportId` string, nullable
    - `websiteId` string, nullable
    - `auditId` string, nullable
    - `config` object, nullable
    - `error` string, nullable
    - `completionReason` string, nullable
    - `completionMessage` string, nullable
    - `costUsd` number, nullable
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
  - `total` integer, required
  - `hasMore` boolean, required

## Other responses

- `401`: Missing or invalid credentials (including the shared auth middleware: no/invalid bearer token). Typed envelope with code `UNAUTHORIZED`. Branch on the `401` status, not the message.
- `429`: Too many requests. Retry after the window resets. (Rate limiting is planned — issue #69 — these headers document the intended contract.)

---

[API](https://skmtc.dev/squirrelscan/apis/squirrelscan-public-api.md) · [All operations](https://skmtc.dev/squirrelscan/apis/squirrelscan-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/squirrelscan/apis/squirrelscan-public-api/revisions/82c8183fe8bc?raw)