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

# Lister les audits de prospection

> Listez les instantanés d’audits de prospection, en lecture seule, disponibles pour votre workspace agence.

Renvoie les audits de prospection créés par le workspace agence rattaché au jeton d’API. Cet endpoint est en lecture seule et ne lance, ne relance ni ne modifie jamais un audit.

<Note>
  Seuls les audits de prospection appartenant à un workspace agence associé à l’équipe du jeton sont renvoyés. L’accès général à l’API reste soumis aux règles d’offre décrites dans l’[Introduction](/fr/developers/introduction).
</Note>

<ParamField header="Authorization" type="string" required>
  Jeton d’API bearer. Exemple : `Bearer qw-api-xxx`
</ParamField>

## Paramètres de requête

<ParamField query="status" type="string">
  Filtre par `PENDING`, `RUNNING`, `RECOVERING`, `AWAITING_PROMPTS`, `COMPLETED` ou `FAILED`.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Nombre d’audits à renvoyer. Maximum : 100.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Nombre d’audits à ignorer.
</ParamField>

## Réponse

<ResponseField name="pagination" type="object">
  Total, nombre, limite et décalage de la page actuelle.
</ResponseField>

<ResponseField name="audits" type="array">
  <Expandable title="Résumé de l’audit de prospection">
    <ResponseField name="id" type="string">Identifiant de l’audit de prospection.</ResponseField>
    <ResponseField name="brandName" type="string">Nom du prospect.</ResponseField>
    <ResponseField name="domain" type="string">Domaine du prospect.</ResponseField>
    <ResponseField name="status" type="string">Statut actuel de l’audit.</ResponseField>
    <ResponseField name="scores" type="object">Score GEO, taux de mention, position, sentiment, part de voix, citations et totaux lorsqu’ils sont disponibles.</ResponseField>
    <ResponseField name="competitors" type="array">Concurrents détectés. Chaque ligne inclut un `subjectId` accepté par l’endpoint de détail.</ResponseField>
    <ResponseField name="reportReady" type="boolean">Indique si le rapport terminé est prêt à être lu.</ResponseField>
    <ResponseField name="team" type="object">Identifiant et nom du workspace agence.</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/pitch-audits?status=COMPLETED&limit=20" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": { "total": 8, "count": 1, "limit": 20, "offset": 0 },
  "audits": [
    {
      "id": "8a218180-6dd7-43c7-a481-f6a1cc72dfd8",
      "brandName": "Northstar Labs",
      "domain": "northstar.example",
      "status": "COMPLETED",
      "promptCount": 20,
      "competitorCount": 4,
      "scores": { "geoScore": 71, "mentionRate": 60 },
      "competitors": [
        {
          "subjectId": "orbit.example",
          "name": "Orbit Systems",
          "domain": "orbit.example",
          "score": 64
        }
      ],
      "reportReady": true,
      "team": { "id": "team-123", "name": "Agency workspace" }
    }
  ]
}
```

## Étape suivante

Utilisez l’identifiant d’audit renvoyé avec [Obtenir un audit de prospection](/fr/developers/endpoints/pitch-audits/get). Utilisez le `subjectId` d’un concurrent avec [Obtenir le rapport d’un sujet](/fr/developers/endpoints/pitch-audits/get-report).

## Erreurs

| Statut | Code | Description |
| - | - | - |
| `400` | `INVALID_PARAMETER` | Valeur de statut ou de pagination invalide |
| `401` | erreur de passerelle | Échec de l’authentification |
| `429` | erreur de passerelle | Limite de débit dépassée ; respectez `Retry-After` |


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