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

# List audit runs

`GET /api/v1/runs`

## Request

- Base URL: `https://index365.co`
- URL: `https://index365.co/api/v1/runs`
- Auth: HTTP bearer

Cursor-paginated runs, newest first. Filter with projectId and status. List items are compact but carry score state (completed runs only) and finishedAt, so ranking or picking the latest run never needs per-run fetches. score is null with scoreStatus=unverified when source-only evidence needs rendered verification; call get_run for links and full detail.

## Query parameters

- `limit` integer
- `cursor` string
- `projectId` string, uuid
- `status` 'pending' | 'running' | 'completed' | 'failed' | 'failed_auto_credit' | 'refunded'

## Response `200`

Run page.

- object
  - `runs` object[], required
    - `runId` string, uuid, required
    - `projectId` string, uuid, nullable, required
    - `product` 'ai_readiness' | 'marketing_signal' | 'marketing_signal_v2' | 'website_security', required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'failed_auto_credit' | 'refunded', required
    - `progressPct` integer, required
    - `url` string, required
    - `score` integer, nullable, required
    - `scoreStatus` 'unverified' | 'null', nullable, required: unverified when source-only page evidence needs rendered verification.
    - `scanMode` string, nullable, required
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required
    - `finishedAt` string, date-time, nullable, required
  - `pagination` object, required
    - `nextCursor` string, nullable, required
    - `limit` integer, required

## Other responses

- `400`: Unknown status filter (error.code=validation_failed).
- `401`: Missing/unknown/revoked API key.
- `403`: Key lacks the required scope (error.code=insufficient_scope).
- `429`: Rate limit exceeded (60 req/min per key). Honor Retry-After.

---

[API](https://skmtc.dev/index365/apis/index365-api.md) · [All operations](https://skmtc.dev/index365/apis/index365-api/llms.txt) · [OpenAPI document](https://skmtc.dev/index365/apis/index365-api/revisions/87dd7b85edcb?raw)