> ## 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 le rapport d’un sujet d’audit

> Lisez la vue d’un concurrent ou d’un co-concurrent dérivée d’un audit de prospection.

Le rapport d’un sujet réorganise les données du même audit de prospection autour d’un concurrent ou d’un co-concurrent détecté. Il ne crée pas de second audit et ne régénère aucune donnée.

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

## Paramètres de chemin

<ParamField path="auditId" type="string" required>
  Identifiant de l’audit de prospection parent.
</ParamField>

<ParamField path="subjectId" type="string" required>
  Valeur renvoyée par `competitors[].subjectId`, `availableSubjects[].id` ou `coCompetitors[].subjectId`.
</ParamField>

## Paramètres de requête

<ParamField query="includeAnswers" type="boolean" default="false">
  Inclut le texte complet des réponses IA. Par défaut, seule la synthèse limitée du rapport est renvoyée.
</ParamField>

<ParamField query="includeCoCompetitorScores" type="boolean" default="false">
  Ajoute la synthèse de scores complète à tous les co-concurrents du sujet sélectionné.
</ParamField>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/orbit.example" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

Pour inclure les réponses :

```bash theme={null}
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/orbit.example?includeAnswers=true" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

La réponse utilise le même schéma de rapport que [Obtenir un audit de prospection](/fr/developers/endpoints/pitch-audits/get). Son `reportSubject` identifie le concurrent sélectionné, et ses lignes `coCompetitors` renvoient vers d’autres sujets résolubles. Suivez le `reportUrl` de la ligne du prospect d’origine pour revenir au rapport de base.

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `INVALID_PARAMETER` | Paramètre de requête ou de sujet invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | `PITCH_AUDIT_NOT_FOUND` | Audit ou sujet demandé inaccessible |
| 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.