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

> Header tallies for every tracked competitor, in one read

Every tracked competitor's header tallies in a single read: people tracked, interactions, accounts touched, the attack/defend split, and the at-risk count. It replaces calling [the battlecard](/api-reference/get-competitor-detail) once per competitor when all you want is the scoreboard.

Attack, defend and at-risk come from one tenant-wide overlay of your live CRM over every competitor's touched accounts, so the numbers are comparable across competitors rather than each being computed in its own pass.

## Query parameters

<ParamField query="from" type="string">
  Window start, RFC 3339. Omit for all time.
</ParamField>

<ParamField query="to" type="string">
  Window end, RFC 3339.
</ParamField>

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

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

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

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "summaries": [
        {
          "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "competitor_name": "Globex Inc",
          "persons_tracked": 24,
          "interactions": 2871,
          "accounts_touched": 148,
          "atk_accounts": 101,
          "def_accounts": 47,
          "at_risk": 6
        },
        {
          "competitor_id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
          "competitor_name": "Initech",
          "persons_tracked": 11,
          "interactions": 1257,
          "accounts_touched": 82,
          "atk_accounts": 66,
          "def_accounts": 16,
          "at_risk": 3
        }
      ]
    }
  }
  ```
</ResponseExample>