List audit runs

List your audit runs

GET / v1 / agent-runs

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

Query parameters

limit integer default: 20

Page size (1–100).

offset integer default: 0

Number of items to skip.

status string

Available options: pending, running, completed, failed, cancelled

mode "audit" | "audit-fix" | "fix" | "recommend"

Available options: audit, audit-fix, fix, recommend

websiteId string

Responses

Paginated list of audit runs.

runs object[] required

Audit run as returned by the list endpoint. Also the shared base for the single-run `AuditRun` schema, which composes this plus `userId`/`orgId` via `allOf` — so the common fields live in exactly one place. Nullable fields are unset until the run progresses.

total integer required

hasMore boolean required

curl --request GET \
  --url "https://api.squirrelscan.com/v1/agent-runs"

const res = await fetch("https://api.squirrelscan.com/v1/agent-runs", {
  method: "GET",
});
const data = await res.json();

import requests


r = requests.get("https://api.squirrelscan.com/v1/agent-runs")
r.raise_for_status()
data = r.json()

{
  "runs": [],
  "total": 123,
  "hasMore": true
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>"
  }
}

Edit this page