Transition from Consumption APIs to Cost Management APIs

  • Article
  • 02/14/2025

This article informs developers that use the Consumption APIs about important changes. There are newer Microsoft Cost Management APIs available that offer enhanced capabilities and have the most up-to-date functionality. We recommend that you transition from the Consumption APIs to the Cost Management APIs. The Consumption APIs are in maintenance mode and are on a path to deprecation.

Note

These APIs differ from the Enterprise Agreement (EA) reporting APIs that are already retired.

Replacement APIs

Here's a comparison of the APIs. The Cost Management APIs are the recommended replacement for the Consumption APIs. The Cost Management APIs are also the replacement for the EA reporting APIs that are already retired.

Use Azure Enterprise Reporting APIs (retired) Microsoft Consumption APIs Microsoft Cost Management APIs (recommended)
Authentication API key provisioned in the Azure portal Microsoft Entra authentication using user tokens or service principals. Service principals take the place of API keys. Microsoft Entra authentication using user tokens or service principals. Service principals take the place of API keys.
Contract EA EA and Microsoft Customer Agreement (MCA) EA and MCA
Endpoint URI https://consumption.azure.com https://management.chinacloudapi.cn https://management.chinacloudapi.cn
API Status Deprecated Usage Details API and Marketplaces API are planned for deprecation Active

The Cost Management APIs also support all of the latest functionality, such as Savings Plan.

Consumption APIs deprecation status

The following Consumption APIs are planned for deprecation. We recommend that you avoid building your reporting pipelines using these APIs. You should migrate away from them as soon as possible.

API Recommended Deprecation Status
Usage Details API Cost Details API or Exports Maintenance mode. Will be deprecated in the future.
Marketplaces API Cost Details API or Exports Maintenance mode. Will be deprecated in the future.

Related content