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

# Get run stats

> Return aggregate statistics for a specific run.

Returns the same metrics object available in the runs list, but for a single run by ID. Useful when you already know the `runId` and want metrics without fetching the full list.

### Path parameters

<ParamField path="runId" type="string" required>
  The run UUID. Obtain it from [List runs](/api-reference/runs/list).
</ParamField>

### Request

```bash theme={null}
curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/runs/RUN_ID/stats"
```

### Response

<ResponseField name="metrics" type="object">
  See the metrics schema in [List runs](/api-reference/runs/list).
</ResponseField>

```json theme={null}
{
  "id": "run-uuid-123",
  "brandId": "brand-uuid-123",
  "startedAt": "2025-02-01T10:00:00Z",
  "metrics": {
    "present": 120,
    "positive": 80,
    "negative": 20,
    "neutral": 20,
    "responsesWithBrands": 100,
    "totalResponses": 150,
    "completedResponses": 150,
    "averageRank": 1.8,
    "mentionedBrandsRun": {
      "competitor-x": 45,
      "competitor-y": 30
    },
    "topics": {
      "Pricing": { "present": 40, "positive": 30 },
      "Support": { "present": 30, "negative": 5 }
    },
    "calculatedAt": "2025-02-01T10:30:00Z"
  }
}
```