# Usage

`mapbox usage` reports account or token usage by product, by day.

-   [`mapbox usage`](#mapbox-usage)

## `mapbox usage`

Usage per Mapbox product, by day, for the whole account or one token.

This calls the Statistics API, which is gated two ways: your account needs to be enabled for it by Mapbox support, and your token needs the `statistics:read` scope. `mapbox auth login` requests that scope by default — log in again if your stored token predates that.

**Parameters:**

| Parameter | Description |
| --- | --- |
| `--period-start <YYYY-MM-DD>` | Start of the usage period, inclusive. Defaults to 30 days ago. |
| `--period-end <YYYY-MM-DD>` | End of the usage period, inclusive. Defaults to today. At most 31 days after `--period-start`. |
| `--product <name>` | Only show this product. Matches the API's own name for it case-insensitively, in whole or in part — `"search box"` matches `"Search Box API - Requests"`. |
| `--token-id <id>` | Show usage for one token instead of the whole account. See [`mapbox accounts list-tokens`](https://docs.mapbox.com/cli/reference/accounts/#mapbox-accounts-list-tokens) for ids. |
| `--daily` | List each product's usage day by day, newest first, instead of a sparkline. Only changes `-o text`; `-o json` always has the daily figures. |

**Examples:**

```sh
mapbox usage
mapbox usage --period-start 2026-01-01 --period-end 2026-01-31
mapbox usage --product "Vector Tiles API"
mapbox usage --product "Vector Tiles API" --daily
mapbox usage --token-id cmtoken00000000000000001a
```