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

# anona-compute usage

> Show usage and cost for a billing period

```text
Show the organization's usage and cost for a billing period (GET /v1/usage on the gateway):
meters, totals with the part not yet rated, a projection for the current month, and the
most expensive sandboxes.

--top N lists the N most expensive sandboxes, reading as many pages of up to 1000 as it
takes; --sandbox ID shows one sandbox's row instead. With --json, --top N puts that many
rows in the document's sandboxes (without --top it holds the gateway's default page of 50),
and next_cursor is set when more remain.

Browser logins of any role may read usage; API keys need the usage:read scope.
--billing prints the plan, rates and invoices instead (GET /v1/billing): owners and admins,
or keys with billing:read. --json prints the gateway's whole document, with snake_case keys.
```

## Usage

```text
anona-compute usage [flags]
```

## Flags

| Flag | Type | Description |
| - | - | - |
| `--billing` | | show plan, rates and invoices instead (owners, admins, keys with billing:read) |
| `--help`, `-h` | | help for usage |
| `--period` | string | billing period: current or YYYY-MM (default "current") |
| `--sandbox` | string | show this sandbox's usage row instead of the most expensive ones |
| `--top` | int | list this many of the most expensive sandboxes, across pages (0 = none) (default 5) |

Global flags (`--api-key`, `--api-url`, `--json`, `--output`, `--profile`, `--request-timeout`, `--verbose`) work on every command; see [anona-compute](/docs/cli/reference/anona-compute.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.