# Summary

Source: https://aiand-docs-staging.pages.dev/analytics/summary/

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

Returns request counts and input and output token totals for the requested range and for an earlier window, plus a token timeseries for the current range. Use this for "headline number" displays.

## Query parameters

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

## Response

```json
{
  "current": {
    "requests": 87432,
    "input_tokens": 12345678,
    "output_tokens": 234567
  },
  "previous": {
    "requests": 80110,
    "input_tokens": 11023456,
    "output_tokens": 198765
  },
  "timeseries": [
    { "timestamp": "2026-05-11T00:00:00", "tokens": 1804321 },
    { "timestamp": "2026-05-11T01:00:00", "tokens": 1756789 }
  ]
}
```

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