# Usage

URL: https://docs.hanzo.ai/docs/cli/usage

> The `hanzo usage` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/usage) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/usage) · [SDKs](https://docs.hanzo.ai/docs/sdks)

What your org ran and what it cost, broken down per account.

[API reference →](https://docs.hanzo.ai/docs/openapi/usage)

```bash
hanzo usage samples
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command               | What it does                                                                                                                                                                                                                                                                |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo usage create`  | Ingests a batch of account-usage samples — what a developer's OWN AI accounts have consumed of their OWN plans, metered from each provider's own login — and appends them to the warehouse series.                                                                          |
| `hanzo usage samples` | The PER-PROVIDER view: one connected account's own consumption of its own plan — "my plan is 47% through its 6h window, resets at 14:20".                                                                                                                                   |
| `hanzo usage summary` | Answers GET /v1/usage/summary: the caller's own usage footprint over one window — the categorized spend roll-up from the commerce ledger, the org's LLM usage totals from the warehouse, and the caller's OWN linked provider accounts beside the org's Hanzo-routed usage. |

### Analytics

| Command                        | What it does                                                                                                                                                           |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo usage analytics access` | Echoes a plan's resolved analytics entitlement so a dashboard can configure itself against the LIVE catalog instead of hardcoding tier numbers.                        |
| `hanzo usage analytics get`    | The entitlement-GATED per-provider breakdown of the caller org's LLM usage — the paid lens over the same warehouse ledger GET /v1/usage/summary reads its totals from. |