Current release

Release Notes (2.7.0) : Released 29th May 2025

Release Notes (2.6.0) : Released 28th February 2025

Added support for a US Edition of basemap styles. Added unitedStatesOfAmerica to the list of available Worldviews. This option is available for existing basemap styles that support the worldview query parameter.
Resolved a bug with worldview for ArcGIS Light-Gray/Dark Gray and Human Geography Labels layers.

Release Notes (2.5.0) : Released 10th February 2025

Release Notes (2.4.0) : Released 13th June 2024

The following styles now support the places parameter:
- arcgis/imagery
- arcgis/imagery/labels
- arcgis/streets
- arcgis/streets-night

Release Notes (2.3.0) : Released 6th March 2024

The worldview query parameter is no longer in beta - see API reference. This parameter allows you to control the display of disputed borders and labels for specific countries, for key ArcGIS styles. To learn more, see this page.
The places query parameter is no longer in beta - see API reference. This option allows you to control the display of places, or points of interest, on arcgis/navigation and arcgis/navigation-dark styles. With the attributed option, you can also fetch additional details about a place or point of interest. To learn more about this workflow, see this page.
Using a style with places=attributed is now rendered correctly with MapLibre.
The self describing endpoints now include details of supported places and worldview options for a given style.
Duplicate query parameters are now rejected to avoid ambiguity of requests.

Release Notes (2.2.0) : Released 10th November 2023

Includes the following new features:

Beta

A places query parameter that allows you to display places with arcgis/navigation and arcgis/navigation-dark styles.
A worldview query parameter that allows you to display worldview borders and labels for specific countries using some ArcGIS styles.

NOTE: These are beta features with some limitations. To ask questions or provide feedback, please go to the Early Adopter Community.

Release

The basemap styles service will now enforce that your token or API key has the premium:user:basemaps privilege (available for all keys by default).
Added OpenAPI Specification endpoints. This gives developers access to the yaml description of the API.
Added new endpoints that describe the service capabilities in JSON, which allows the user to build dynamic UI apps such as a basemap picker.
- arcgis/rest/services/styles/v2/self
- arcgis/rest/services/styles/v2/webmaps/self
- arcgis/rest/services/styles/v2/styles/self
Addressed problem with Access-Control-Headers when making a preflight header request.
Fixed issue with the display of Arabic labels for osm/light-gray and osm/dark-dray styles.
Improved language code fallback for unsupported languages - for example using fr-CA will now result in fr.
Return more informative response messages when a given item id does not correspond to a style.
HTTP response headers now contain cache control values. These allow clients to keep their cached responses for a sensible amount of time.

Release Notes (2.1.0) : Released August 2023

The basemap styles service (v2) includes several improvements to the basemap styles service (v1).

This includes the following:

New service URL endpoints to return map styles according to the Mapbox Style Specification or the Esri Web Map Specification.
New ArcGIS and OSM map styles:
Extended language support for place labels and local language support options.
API key support and HTTP header authentication.
Open API specification compliant.
Error response that use standard HTTP status codes (e.g. 400 or 401) rather than 200.