Statistics and usage

Your Statistics page displays analytics information about the Mapbox products used by your account and only includes billable statistics for products found on the pricing page.

To access the Statistics page, log into your account and navigate to

Not included in this guide

The purpose of the Statistics page is to provide insight into an account's usage data for the billable products listed on the pricing page. Information about API rate limits, API performance, and HTTP status codes of requests to the Mapbox APIs are not displayed on the Statistics page. Please visit the API documentation for additional information about each service.

Filter usage data

There are two ways to filter the Mapbox usage data on your Statistics page:

  • By date: Choose a standard period (such as week or month) or enter a custom date range. All dates are in UTC (Greenwich Mean Time). Usage data will be available on the Statistics page within 24 hours.
  • By access token: See usage for all access tokens or one specific access token. Legacy SDKs for Mobile statistics are not available when filtering by access token. To see Legacy SDKs for Mobile statistics, filter by All tokens and connected apps.

Browse by product

Your account usage is organized by product on your Statistics page. For each product, you'll see the number of metered units for the token and time period selected.

You will only see statistics for the products you’ve used within the specified time period and with the specified token. For more detailed explanations of how usage is metered for each product, see Pricing by products.

Additional metrics

For many products, you can load additional metrics about the Countries, Browsers, Domains, and Tileset IDs associated with your requests. These additional metrics are presented as percentages of the total number of metered units for the specified time period and token.

Additional metrics are not available for products that are metered by user count (such as Maps SDK for Mobile). They are also not available for time periods exceeding 31 days.

Have questions about the Statistics page? Let our Support team know- we're happy to help!


Not set and Other values

When you see Not set as an additional metric value, it means that for some requests we are not able to find a value for that metric. With the additional metric Domains, for example, Not set means the request did not include a referrer from which we could parse a domain, which may because your requests are not coming from web browsers, or because you are using an legacy version of GL JS. Upgrading to the latest version of GL JS should reduce the number of Not set domains and is a requirement for implementing URL restrictions.

When you see Other as an additional metric value, it means we are not able to convert the value to a legible display format. For example, for the additional metric Browsers, Other means we are not able to simplify the request's user agent to a display format.

Statistics for deleted access tokens

The names of deleted tokens do not show up in the drop-down filter list. Statistics tied to a deleted token will be aggregated in the All tokens and connected apps view. It is not possible to isolate statistics for a token after it has been deleted.

Inconsistencies between usage on your Statistics page and charges on your monthly invoice

If you've set the custom date on your Statistics page to match your billing cycle and notice a discrepancy in the values of services you were billed for, it's most likely an issue with timezones. Requests attributed to your billing period that were not invoiced during that month will roll over to the next invoice.

CSV Export

We don't yet support an export feature on the Statistics page but would love to hear your feature requests around a CSV download option - contact us to share your use case.

Was this page helpful?