# Summary

Source: https://staging-docs.aiand.com/analytics/summary/

```http
GET /analytics/summary?range=<range>
```

Returns a single aggregated row over the requested range — counts, token totals, cost, and error rate. Use this for "headline number" displays.

## Query parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `range` | string | Yes | One of `1h`, `24h`, `7days`, `30days`, `3months`. |

## Response

```json
{
  "range": "7days",
  "from": "2026-05-11T00:00:00Z",
  "to": "2026-05-18T00:00:00Z",
  "requests": 87432,
  "input_tokens": 12345678,
  "output_tokens": 234567,
  "cost_usd": 42.18,
  "errors": 312,
  "p50_latency_ms": 410,
  "p95_latency_ms": 1820
}
```

## Caching

Responses are cached for **120 seconds** with singleflight deduplication.

## Auth

API key or JWT + `X-Org-ID`. See [Authentication](/authentication/).

<Aside type="tip">
  For per-request detail with cursor pagination, use [Request Logs](/analytics/logs/) instead.
</Aside>
