---
title: "Poll an audit run"
method: GET
path: "/v1/audits/{auditId}"
tags: ["Audits"]
---

# Poll an audit run

`GET /v1/audits/{auditId}`

## Request

- Base URL: `https://serp-agent.com`
- URL: `https://serp-agent.com/v1/audits/{auditId}`
- Auth: HTTP bearer

Status of a technical audit. `status` walks queued → running → completed (or failed). Completed audits carry `score` (0–100) and a SUMMARIZED report: severity counts, top issues grouped per check (capped at 10, worst first), and per-category scores — never a raw page-by-page dump. Failed audits carry `error`.

## Path parameters

- `auditId` string, required

## Response `200`

Current audit state.

- Audit
  - `audit_id` string, required
  - `project_id` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed', required
  - `started_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `score` integer, nullable: Overall score 0–100. Present only when completed.
  - `summary` AuditSummary: Summarized audit report — severity counts, top issues (grouped per check, capped at 10, worst first), and per-category scores.
    - `issues_critical` integer, required
    - `issues_warning` integer, required
    - `issues_info` integer, required
    - `top_issues` object[], required
      - `check` string, required: Check type, e.g. SSL, PAGESPEED, SITEMAP, CANONICAL, MOBILE.
      - `severity` 'critical' | 'warning' | 'info', required
      - `title` string, required
      - `affected_count` integer, required
    - `categories` object, required: Average score 0–100 per category (performance, security, indexability, mobile, structure, other). Only categories with scored checks appear.
  - `error` string: Present only when failed.

## Other responses

- `401`: Missing, malformed, unknown, revoked, or expired API key. Codes: `unauthorized`, `key_revoked`, `key_expired`.
- `404`: No such audit on this account. Code: `not_found`.
- `429`: Rate limit exceeded (600 requests/minute per API key). Honor `Retry-After`.

---

[API](https://skmtc.dev/serp-agent/apis/serp-agent-api.md) · [All operations](https://skmtc.dev/serp-agent/apis/serp-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/serp-agent/apis/serp-agent-api/revisions/438a943019ac?raw)