Audits

Poll an audit run

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.

get/v1/audits/{auditId}

Request

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

Path parameters

auditIdstring required

Audit id from POST /v1/projects/{projectId}/audits.

Response

Current audit state.

audit_idstring required
project_idstring required
status'queued' | 'running' | 'completed' | 'failed' required
started_atstring date-time nullable required
completed_atstring date-time nullable required
scoreinteger nullable

Overall score 0–100. Present only when completed.

errorstring

Present only when failed.

Changes

No recorded changes to this operation across all 1 revision of this API.