
We encourage you to use the newest available version of the Mapbox APIs. The version string for a given Mapbox API can be incremented independently from other Mapbox APIs. API versioningĮach Mapbox API has a version string that is specified in the base URL. If the example API request does require a secret scope, the example will specify which scope is required. The example requests in this documentation will include your default access token if you are signed into your Mapbox account and the API request does not require any secret scopes. If no scope is specified, then your default access token will work to access that endpoint. Throughout this documentation, we specify the scope required to access each endpoint. Each scope adds a different permission to the token, allowing it to be used to access restricted APIs. When you create a new access token, you can give it one or more token scopes. You can also create and manage additional tokens on your Access tokens page or with the Tokens API. Your default access token is available on your Account dashboard. You must supply a valid access token by using the access_token query parameter in every request. To access the Mapbox API endpoints, you need a valid access token, which will connect API requests to your account. This base path goes before the endpoint path. All URLs referenced in the documentation have the base path. Reading this documentationĮach API endpoint in this documentation is described using several parts: The Mapbox APIs described in this documentation are subject to Mapbox's Terms of Service.
