> ## 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 Pitch Audit

> Read the original prospect report for a Pitch Audit

Returns the original prospect's read-only Pitch Audit report: profile, prompts, scores, competitors, sources, insights, recommendations, and co-competitors.

<ParamField header="Authorization" type="string" required>
  Bearer API token. Example: `Bearer qw-api-xxx`
</ParamField>

### Path Parameters

<ParamField path="auditId" type="string" required>
  Pitch Audit ID returned by [List Pitch Audits](/developers/endpoints/pitch-audits/list).
</ParamField>

### Query Parameters

<ParamField query="includeAnswers" type="boolean" default="false">
  Include full AI answer text. Keep the default for a bounded report payload; request answers explicitly when evidence-level analysis is required.
</ParamField>

<ParamField query="includeCoCompetitorScores" type="boolean" default="false">
  Attach the complete `scores` summary to every `coCompetitors` row. Use this expansion to compare all co-competitors in one request.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  `true` when the report was returned.
</ResponseField>

<ResponseField name="team" type="object">
  Agency workspace ID and name.
</ResponseField>

<ResponseField name="audit" type="object">
  <Expandable title="Pitch Audit report">
    <ResponseField name="reportSubject" type="object">The original prospect or competitor represented by this report.</ResponseField>
    <ResponseField name="availableSubjects" type="array">Every subject that can be requested through `subjectId`.</ResponseField>
    <ResponseField name="summary" type="object">Scores, providers, competitor leaderboard, sources, insights, technical readiness, claims, and recommendations.</ResponseField>
    <ResponseField name="answersIncluded" type="boolean">Whether full answer evidence was requested.</ResponseField>
    <ResponseField name="coCompetitorScoresIncluded" type="boolean">Whether every co-competitor row includes its full score summary.</ResponseField>
    <ResponseField name="answerCount" type="number">Number of answers available in the report.</ResponseField>
    <ResponseField name="answers" type="array">Full AI answer evidence. Present only when `includeAnswers=true`.</ResponseField>
    <ResponseField name="coCompetitors" type="array">Brands appearing in the same answers as the current subject. Every row includes a resolvable `subjectId`, `reportUrl`, co-occurrence metrics, and optionally `scores`.</ResponseField>
  </Expandable>
</ResponseField>

### Original Prospect

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

### Co-competitor Navigation

Take `subjectId` and the canonical `reportUrl` directly from a `coCompetitors` row:

```json theme={null}
{
  "id": "rival.com",
  "subjectId": "rival.com",
  "name": "Rival",
  "sharedAnswers": 12,
  "subjectAvgPosition": 2.1,
  "competitorAvgPosition": 1.7,
  "sharedSourcesCount": 9,
  "reportUrl": "/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/rival.com"
}
```

Follow `reportUrl`, or see [Get Pitch Audit Subject Report](/developers/endpoints/pitch-audits/get-report). A co-competitor is a derived view of the same audit, not a separate audit record.

### List and Score Every Co-competitor

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

Read `audit.coCompetitors`. Each row includes the relationship metrics plus `scores.geoScore`, `scores.mentionRate`, `scores.avgPosition`, `scores.sentimentScore`, `scores.shareOfVoice`, and citation metrics. Use `subjectId` only when you need the full derived report.

### Errors

| Status | Code                    | Description                                  |
| ------ | ----------------------- | -------------------------------------------- |
| 400    | `INVALID_PARAMETER`     | Invalid query parameter                      |
| 401    | `INVALID_TOKEN`         | Authentication failed                        |
| 404    | `PITCH_AUDIT_NOT_FOUND` | Audit or requested subject is not accessible |