Statistics and usage
Your account's Statistics page displays usage information for all billable products found on the pricing page.
To access the Statistics page, log into your account and navigate to the Statistics page of your Developer Console.
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. 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, active 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.
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.
Troubleshooting
Update frequency
If you began using a service for the first time or updated your implementation recently, allow up to 24 hours for the usage to be reflected on your Statistics page. You can check the status for all Mapbox services, including the Statistic's page, at https://status.mapbox.com/.
Relating service usage to service costs
When reviewing your Statistics page, you can reference the Pricing page and the Pricing by product documentation to understand each service's metric of billing, monthly free tier, pricing, and progressive discounts. For a general overview of how Pay-as-you-go billing works, we recommend the guide for What to Expect and the Billing emails documentation.
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 a legacy version of GL JS. Upgrading to the latest version of GL JS should reduce the number of Not set domains and is a rule for implementing URL restrictions.
When you see Other as an additional metric value, it means our systems 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
When an access token is deleted, caching throughout our global infrastructure may result in successful requests to that deleted token. Caching settings vary - not all Mapbox services cache requests for the same length of time.
It is not possible to isolate statistics for a token after it has been deleted. Deleted tokens do not show up in the drop-down filter list, rather, usage data tied to a token before and after its deletion will be aggregated in the All tokens and connected apps view.
Statistics for temporary access tokens
Temporary tokens (tk) are not displayed in the drop-down filter list. Instead, usage data tied to temporary tokens will be aggregated in the All tokens and connected apps view. To visualize statistics generated by tk tokens in a time period, append ?&token=tk to the end of the statistic page's URL.
Statistics for legacy services by token
It's possible that your Mapbox implementation is using a legacy version of a Mapbox service that does not pass access tokens to our servers with it's requests. If this is the case, usage data cannot be isolated by token. Usage in this category will be aggregated and displayed when the All tokens and connected apps view is selected.
Similarly, 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. To isolate MAUs by token from a specific time moving forward, upgrade your applications to the latest versions of the Maps SDKs, and review statistics after the update is deployed.
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.
Have questions about the Statistics page? Let our Support team know- we're happy to help!
Feature requests
CSV Export
The Statistics page does not support an export or download feature. Contact your Technical Account Manager or Account Manager to submit a feature request, or contact support to share your use case.
Programmatic access
Mapbox usage data is not available through an API service. Contact your Technical Account Manager or Account Manager to submit a feature request, or contact support to share your use case.