Usage
mapbox usage reports account or token usage by product, by day.
mapbox usage
Usage per Mapbox product, by day, for the whole account or one token.
Private preview
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 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:
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
Was this page helpful?