> ## 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.

# Obtenir un audit de pages

> Lisez le statut d’un audit de pages et l’avancement de chaque page auditée. Interrogez-le après une réponse 202, ou attendez le webhook site_audit.completed.

Renvoie le statut d’un audit de pages et le statut de chaque page auditée. C’est la ressource identifiée par l’en-tête `Location` de [Lancer un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/start-audit.md).

Le résultat final de chaque page appartient à cet audit et ne change pas lorsqu’un nouvel audit est lancé. `COMPLETED` signifie que toutes les pages ont atteint un état final, pas qu’elles ont toutes réussi : consultez `counts.failed` et `counts.skipped`. Un traitement interrompu peut rester `QUEUED` ou `AUDITING` pendant la récupération de son résultat exact. Une page dont le traitement ne peut plus exister est `FAILED` : la mise en file est relancée dans les 24 heures qui suivent l’acceptation, 12 fois au plus, et les traitements en file expirent après 7 jours. Un traitement encore actif dans la file est attendu. [Obtenir une page suivie](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/get.md) renvoie les scores les plus récents de cette page, qui peuvent provenir d’un audit ultérieur.

Disponible avec les offres Growth, Agency Growth, Business, Agency Business et Enterprise. Consultez [Authentification](https://docs.qwairy.co/fr/developers/authentication.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**siteAuditId** `string` *required*

Identifiant de l’audit renvoyé au lancement de l’audit.

## Réponse

**id** `string | null`

Identifiant de l’audit. `null` uniquement pour un dry run, que cet endpoint ne renvoie jamais

**status** `string`

`RUNNING` ou `COMPLETED`. Un dry run de [Lancer un audit de pages](https://docs.qwairy.co/fr/developers/endpoints/site-diagnostics/start-audit.md) renvoie `PREVIEW`

**creditsReserved** `integer`

Budget de l’audit : 5 crédits par page à auditer, ajusté si des pages sont refusées à l’envoi. Ni une réservation immédiate ni le montant final consommé

**counts** `object`

Nombres de pages `total`, `succeeded`, `failed`, `skipped` et `running`.

**pages** `array`

Une entrée par page avec `pageId`, `status` (`QUEUED`, `AUDITING`, `COMPLETED`, `FAILED` ou `SKIPPED`) et `completedAt` (nullable).

**createdAt** `string`

Date de création au format ISO 8601

**completedAt** `string | null`

Date de fin de l’audit au format ISO 8601, ou `null` pendant son exécution. Dès que l’événement [`site_audit.completed`](https://docs.qwairy.co/fr/developers/integration-webhooks/events#site_audit-completed) existe, c’est le `completedAt` de cet événement. Elle peut être postérieure à la date de la dernière page lorsque les dernières pages ont été ignorées ou que la mise en file s’est close plus tard

## Requête et réponse synthétiques

```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"
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `401` | Corps plat | Jeton absent ou invalide |
| `403` | `INSUFFICIENT_PLAN` | Refus d’offre générique : `"This endpoint is not included in the team's plan."` |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace ou l’audit est absent ou inaccessible |

Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md). Sur `429`, respectez `Retry-After`.


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