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. Under
-o text it reads as a chart: one row per product, a sparkline as wide as
the period, each row scaled to its own peak (peak 407/day).
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
このpageは役に立ちましたか？