Skip to main content


Documentation changelog

November 5, 2021

  • The description tables for query parameters and API responses have been updated to include data type information.

July 9, 2021

  • For classic styles, Mapbox no longer supports returning a 200 TileJSON response. Instead the response will return a 410 deprecation notice to encourage upgrading from Classic styles.

February 5, 2021

  • Mapbox no longer offers the Legacy Static Images API, and we have removed its documentation from the /legacy path.

December 16, 2020

December 3, 2020

  • Created service pages and moved each API into its own page.

December 1, 2020

April 17, 2020

  • Remove the deprecated Surface API.

February 25, 2019

  • Updated cURL examples with the {username} placeholder to display a user's username if they are logged in to Mapbox. If the user is not logged in, the cURL request will display the {username} placeholder.

February 5, 2019

  • Restructured the example request and response headers so they are all unique can can be linked to.

February 15, 2018

  • Remove the deprecated Distance API /distances/v1

August 30, 2017

  • Changed all mentions of Starter to Pay-as-you-go and Premium to Commercial per updates to our pricing structure.

April 5, 2016

  • Separates Parameters & Options in all documentation sections for consistency
  • Adds new topic section on how to read documentation

March 4, 2016

  • Clarified that Link is header required for pagination, instead of recommended