API Reference
Audit Status
Poll the status of an audit job as it progresses through the pipeline.
GET
/api/v1/audits/[slug]/statusCheck the current status of an audit job. Use this to poll after submitting a new audit or requesting a re-audit.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
slug | string | Required | Domain slug e.g. notion-com |
Example
Status Progression
Audits move through these stages in order. Poll the status endpoint to track progress.
| Status | Description |
|---|---|
pending | Queued, waiting for a worker |
discovering | Finding competitor domains and classifying taxonomy |
auditing | Running the AEO audit against 22 criteria |
seeding | Storing results in the database |
visibility | Generating AI visibility report |
completed | Audit finished, results available |
failed | Audit failed (see error details) |
Response - In Progress
While the audit is running, current_stage indicates the active pipeline step and overall_score is null.
200Audit in progress
Response - Completed
Once the audit finishes, overall_score contains the final AEO score (0-100) and completed_at is populated.
200Audit completed
Poll at 30-second intervals. Audits typically complete within 3-5 minutes.