> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a page audit

> Read the status of a page audit and the progress of each audited page. Poll it after a 202 response, or wait for the site_audit.completed webhook.

Returns the status of a page audit and the status of each audited page. This is
the resource identified by the `Location` header from
[Start a page audit](https://docs.qwairy.co/developers/endpoints/site-diagnostics/start-audit.md).

Each page's terminal result belongs to this audit and does not change when a
later audit runs. `COMPLETED` means every page has reached a terminal state,
not that every page succeeded: inspect `counts.failed` and `counts.skipped`.
An interrupted treatment can remain `QUEUED` or `AUDITING` while its exact result
is recovered. A page whose run can no longer exist is `FAILED`: queueing is
retried within 24 hours of acceptance, at most 12 times, and queued runs expire
after 7 days. A run that is still active on the queue is waited for.
[Get a monitored page](https://docs.qwairy.co/developers/endpoints/site-diagnostics/get.md)
returns that page's latest scores, which may come from a newer audit.

Available on Growth, Agency Growth, Business, Agency Business and Enterprise plans. See [Authentication](https://docs.qwairy.co/developers/authentication.md).

**Authorization** `string` *required*

Bearer token for your team.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**siteAuditId** `string` *required*

Audit identifier returned when the audit started.

## Response

**id** `string | null`

Audit identifier. `null` only for a dry run, which this endpoint never returns

**status** `string`

`RUNNING` or `COMPLETED`. A dry run of [Start a page audit](https://docs.qwairy.co/developers/endpoints/site-diagnostics/start-audit.md) returns `PREVIEW`

**creditsReserved** `integer`

Audit credit budget: 5 per page to audit, adjusted when dispatch refuses pages. Not an immediate hold or the final amount spent

**counts** `object`

`total`, `succeeded`, `failed`, `skipped` and `running` page counts.

**pages** `array`

One entry per page with `pageId`, `status` (`QUEUED`, `AUDITING`, `COMPLETED`, `FAILED` or `SKIPPED`) and `completedAt` (nullable).

**createdAt** `string`

ISO 8601 creation time

**completedAt** `string | null`

ISO 8601 time when the audit finished, or `null` while it runs. Once the [`site_audit.completed`](https://docs.qwairy.co/developers/integration-webhooks/events#site_audit-completed) event exists, this is the `completedAt` of that event. It can be later than the last page date when the last pages were skipped or queueing closed later

## Synthetic request and response

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/site-diagnostics/audits/$SITE_AUDIT_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "id": "aaaaaaaa-0000-4000-8000-000000000000",
  "status": "COMPLETED",
  "counts": { "total": 1, "succeeded": 1, "failed": 0, "skipped": 0, "running": 0 },
  "creditsReserved": 5,
  "pages": [
    {
      "pageId": "99999999-0000-4000-8000-000000000000",
      "status": "COMPLETED",
      "completedAt": "2026-10-12T09:03:00.000Z"
    }
  ],
  "createdAt": "2026-10-12T09:00:00.000Z",
  "completedAt": "2026-10-12T09:03:00.000Z"
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `401` | Flat body | Missing or invalid token |
| `403` | `INSUFFICIENT_PLAN` | Generic plan refusal: "This endpoint is not included in the team's plan." |
| `404` | `RESOURCE_NOT_FOUND` | The workspace or audit is missing or inaccessible |

Read errors use the flat or nested shapes described in [Error codes](https://docs.qwairy.co/developers/errors.md). On `429`, honor `Retry-After`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.