|
| 1 | +--- |
| 2 | +title: Transition from Consumption APIs to Cost Management APIs |
| 3 | +description: Learn about transitioning from Consumption APIs to Cost Management APIs for enhanced capabilities and up-to-date functionality in managing Azure costs. |
| 4 | +author: bandersmsft |
| 5 | +ms.author: banders |
| 6 | +ms.date: 01/09/2025 |
| 7 | +ms.topic: concept-article |
| 8 | +ms.service: cost-management-billing |
| 9 | +ms.subservice: cost-management |
| 10 | +ms.reviewer: micflan |
| 11 | +#customer intent: As a billing administrator, I want learn about Consumption APIs getting replaced by Cost Management APIs so that I can plan replace them. |
| 12 | +--- |
| 13 | + |
| 14 | +# Transition from Consumption APIs to Cost Management APIs |
| 15 | + |
| 16 | +This article informs developers that use the [Consumption APIs](/rest/api/consumption) about important changes. There are newer [Microsoft Cost Management APIs](/rest/api/cost-management/) 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. |
| 17 | + |
| 18 | +> [!NOTE] |
| 19 | +> These APIs differ from the [Enterprise Agreement (EA) reporting APIs](migrate-ea-reporting-arm-apis-overview.md) that are already retired. |
| 20 | +
|
| 21 | +## Replacement APIs |
| 22 | + |
| 23 | +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](migrate-ea-reporting-arm-apis-overview.md) that are already retired. |
| 24 | + |
| 25 | +| **Use** | **Azure Enterprise Reporting APIs (retired)** | **Microsoft Consumption APIs** | **Microsoft Cost Management APIs (recommended)** | |
| 26 | +| --- | --- | --- | --- | |
| 27 | +| 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. | |
| 28 | +| Contract | EA | EA and Microsoft Customer Agreement (MCA) | EA and MCA | |
| 29 | +| Endpoint URI | `https://consumption.azure.com` | `https://management.azure.com` | `https://management.azure.com` | |
| 30 | +| API Status | Deprecated | Usage Details API and Marketplaces API are planned for deprecation | Active | |
| 31 | + |
| 32 | +The Cost Management APIs also support all of the latest functionality, such as Savings Plan. |
| 33 | + |
| 34 | +## Consumption APIs deprecation status |
| 35 | + |
| 36 | +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. |
| 37 | + |
| 38 | +| **API** | **Recommended** | **Deprecation Status** | |
| 39 | +| --- | --- | --- | |
| 40 | +| [Usage Details API](/rest/api/consumption/usage-details/list) | [Cost Details API](/rest/api/cost-management/generate-cost-details-report) or [Exports](../costs/tutorial-export-acm-data.md) | Maintenance mode. Will be deprecated in the future. | |
| 41 | +| [Marketplaces API](migrate-consumption-marketplaces-api.md) | [Cost Details API](/rest/api/cost-management/generate-cost-details-report) or [Exports](../costs/tutorial-export-acm-data.md) | Maintenance mode. Will be deprecated in the future. | |
| 42 | + |
| 43 | +## Related content |
| 44 | + |
| 45 | +- [Cost Management automation overview](automation-overview.md) |
| 46 | +- [Migrate from Consumption Usage Details API](migrate-consumption-usage-details-api.md) |
| 47 | +- [Migrate from Consumption Marketplaces API](migrate-consumption-marketplaces-api.md) |
0 commit comments