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

> In-flight and recent competitor scans, with status

Your workspace's in-flight (`status: running`) and most-recent competitor scans, with start and finish timestamps.

Poll this to find out whether a scan is running rather than assuming one is — there is no way to start one on demand. A scan starts when you [register a competitor](/api-reference/register-competitor) and when [the schedule](/api-reference/get-monitoring-schedule) fires, and at no other time.

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

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

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

  ```javascript JavaScript theme={null}
  await fetch("https://api.clustr-ai.com/api/public/competitor-runs", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "runs": [
        {
          "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "status": "running",
          "started_at": "2026-07-29T09:00:04Z"
        },
        {
          "competitor_id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
          "status": "completed",
          "started_at": "2026-07-22T09:00:03Z",
          "finished_at": "2026-07-22T09:14:51Z"
        }
      ]
    }
  }
  ```
</ResponseExample>