List audit history

GET https://agentfit.dev/api/public/audit/{id}/history

Return prior audit runs for the same site as run id, newest first, with cursor pagination. Use it to chart how a documentation site's AI-readiness score changes over time.

Request

Parameter	In	Type	Required	Description
`id`	path	string (UUID)	yes	Any `run_id` for the site whose history you want.
`limit`	query	integer	no	Page size, 1–100. Defaults to 20.
`cursor`	query	string	no	Opaque cursor from a previous response's `next_cursor`.

curl

curl -s 'https://agentfit.dev/api/public/audit/019eefa7-fdb7-77ac-8c56-ad184e44ece6/history?limit=5' \
  | jq '.runs[] | {started_at, total_score}'

Python

import requests

run_id = "019eefa7-fdb7-77ac-8c56-ad184e44ece6"
resp = requests.get(f"https://agentfit.dev/api/public/audit/{run_id}/history", params={"limit": 5}, timeout=10)
for run in resp.json()["runs"]:
    print(run["started_at"], run["total_score"])

JavaScript

const runId = "019eefa7-fdb7-77ac-8c56-ad184e44ece6";
const resp = await fetch(`https://agentfit.dev/api/public/audit/${runId}/history?limit=5`);
const { runs } = await resp.json();
runs.forEach((r) => console.log(r.started_at, r.total_score));

Response

runs are newest first; each carries the run id, started_at (RFC 3339), total_score, and status. The top level also echoes the site's base_url/base_url_norm.

{
  "runs": [
    { "id": "019eefa7-fdb7-77ac-8c56-ad184e44ece6", "started_at": "2026-06-22T10:02:11Z", "total_score": 71, "status": "done" },
    { "id": "019ee8c1-2a30-7b14-9f02-1c7785512abc", "started_at": "2026-05-30T08:14:00Z", "total_score": 68, "status": "done" }
  ],
  "next_cursor": "",
  "base_url": "https://docs.stripe.com",
  "base_url_norm": "docs.stripe.com"
}

next_cursor is a string; an empty string means there are no further pages. Pass a non-empty next_cursor back as the cursor query parameter to fetch the next page.

Errors

Status	`code`	Meaning
404	`not_found`	No run exists for that `id`.
400	(no code)	`cursor` is not a valid RFC 3339 timestamp. (`limit` is clamped silently, never an error.)

Note: history is only available through the durable /api/public/audit/* API. The deprecated legacy in-memory poll path has no history endpoint.