> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Competitor Reports

> List your competitor-monitoring reports, newest first

List your workspace's competitor-monitoring reports, newest first. The heavy `report_data` blob is omitted from the list; fetch a single report with [Get Competitor Report](/api-reference/get-competitor-report) for the full attack/defend payload.

See the [report schema](/competitor-monitoring/report-schema) for every field.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.clustr-ai.com/api/public/competitor-monitoring/reports \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  requests.get(
      "https://api.clustr-ai.com/api/public/competitor-monitoring/reports",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "reports": [
        {
          "id": "a7b8c9d0-1234-5678-9abc-def012345678",
          "run_id": "5f6e7d8c-9012-3456-789a-bcdef0123456",
          "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "competitor_name": "Globex Inc",
          "persons_tracked": 12,
          "interactions_found": 47,
          "atk_count": 8,
          "def_count": 3,
          "status": "COMPLETED",
          "created_at": "2026-06-29T09:00:00Z",
          "completed_at": "2026-06-29T09:06:12Z",
          "share_token": "9b2f1e7a-0c44-4d2a-9f3b-7e1c2d4a5b6c"
        }
      ],
      "total": 1
    }
  }
  ```
</ResponseExample>
