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

# Activity Overview

> Inspect routed usage, spend, savings, tokens, and cache activity from the CLI.

Use `dari activity` to read routing activity for your current organization. Commands print JSON so you can inspect them directly or pipe them into `jq`.

Every report requires an RFC 3339 time range:

```bash theme={null}
dari activity overview \
  --from 2026-07-01T00:00:00Z \
  --to 2026-07-08T00:00:00Z
```

The overview includes message and model-step counts, provider spend, estimated savings, token and cache usage, model mix, key sources, and API-key activity.

## Find Filter IDs

List the users, API keys, routers, models, and providers available in a time range:

```bash theme={null}
dari activity filter-options \
  --from 2026-07-01T00:00:00Z \
  --to 2026-07-08T00:00:00Z
```

Extract user IDs with `jq`:

```bash theme={null}
dari activity filter-options \
  --from 2026-07-01T00:00:00Z \
  --to 2026-07-08T00:00:00Z |
  jq '.users[] | {id, name, email}'
```

Pass the returned `id` to `--user-id` or `--comparison-user-id`.

## Common Filters

Activity commands support these filters:

```bash theme={null}
--router-id <router_id>
--api-key-id <api_key_id>       # repeatable
--user-id <user_id>             # repeatable
--model <provider/model>        # repeatable
--provider <provider>
--status <status>
--key-source <managed|byok|subscription>
--source-scope <protocols>
```

Statuses are `completed`, `provider_error`, `selector_error`, and `aborted`. `--source-scope` accepts a comma-separated protocol list, `all`, or `none`.

Time-series reports choose a bucket size from the range: 60s, 5m, 15m, 30m, 1d, 7d, or 30d buckets. Override it with `--bucket-seconds` (one of `60`, `300`, `900`, `1800`, `86400`, `604800`, or `2592000`):

```bash theme={null}
dari activity overview \
  --from 2026-07-01T00:00:00Z \
  --to 2026-07-08T00:00:00Z \
  --bucket-seconds 86400
```

A range cannot exceed 366 days, and a report cannot span more than 1000 buckets. Choose a larger `--bucket-seconds` for long ranges.

## Authentication

Sign in with `dari auth login` or set `DARI_API_KEY` to a Management key. Routing keys cannot read activity.

With browser login, pass `--organization-id` to read an organization other than the current one.

Every command maps to a [routing activity endpoint](/api-reference/managed/activity) on the [management API](/api-reference/managed/overview); use either surface.

## Reports

* [Models & Routing](/router/model-activity/models-routing)
* [People & Keys](/router/model-activity/people-keys)
* [Conversations](/router/model-activity/conversations)
* [Tools & Skills](/router/model-activity/tools-and-skills)