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

# List Pitch Audits

> List the read-only Pitch Audit snapshots available to your agency workspace

Returns Pitch Audits created by the agency workspace attached to the API token. This endpoint is read-only and never starts, retries, or modifies an audit.

<Note>
  Pitch Audits require an agency workspace. REST API access is available on API-enabled agency plans.
</Note>

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

### Query Parameters

<ParamField query="status" type="string">
  Filter by `PENDING`, `RUNNING`, `RECOVERING`, `AWAITING_PROMPTS`, `COMPLETED`, or `FAILED`.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Number of audits to return. Maximum: 100.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of audits to skip.
</ParamField>

### Response

<ResponseField name="pagination" type="object">
  Total, count, limit, and offset for the current page.
</ResponseField>

<ResponseField name="audits" type="array">
  <Expandable title="Pitch Audit summary">
    <ResponseField name="id" type="string">Pitch Audit ID.</ResponseField>
    <ResponseField name="brandName" type="string">Prospect name.</ResponseField>
    <ResponseField name="domain" type="string">Prospect domain.</ResponseField>
    <ResponseField name="status" type="string">Current audit status.</ResponseField>
    <ResponseField name="scores" type="object">GEO score, mention rate, position, sentiment, share of voice, citations, and totals when available.</ResponseField>
    <ResponseField name="competitors" type="array">Detected competitors. Each row includes a `subjectId` accepted by the detail endpoint.</ResponseField>
    <ResponseField name="reportReady" type="boolean">Whether the completed report is ready to read.</ResponseField>
    <ResponseField name="team" type="object">Agency workspace ID and name.</ResponseField>
  </Expandable>
</ResponseField>

### Example Request

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

### Example Response

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

## Next Step

Use the returned audit ID with [Get Pitch Audit](/developers/endpoints/pitch-audits/get). Use a competitor `subjectId` with [Get Pitch Audit Subject Report](/developers/endpoints/pitch-audits/get-report).