ConsumptionManagementClient

Name: ConsumptionManagementClient API
Brand: ConsumptionManagementClient
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceAccountingoauth225 EndpointsREST

For Agents

Pull Azure Enterprise Agreement consumption data — balances, reservation usage, charges, budgets, and forecasts — to power FinOps reports and budget alerts.

Connect the ConsumptionManagementClient to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ConsumptionManagementClient, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with ConsumptionManagementClient API.

Pull EA balance summaries for a billing period to drive monthly cost reconciliation

Retrieve reservation transactions, summaries, and details to track Azure Reserved Instance usage

Generate reservation purchase recommendations sized against the last 7, 30, or 60 days of usage

List Marketplace charges to attribute third-party AppSource costs to subscriptions and resource groups

GET STARTED

Start building with ConsumptionManagementClient API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for ConsumptionManagementClient, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for ConsumptionManagementClient, keeping it validated and agent-ready. The Consumption Management Client provides read access to consumption resources for Azure Enterprise Subscriptions across 25 endpoints — balances, reservation summaries and details, reservation transactions, reservation recommendations, marketplaces, budgets, charges, forecasts, and more. Use it to feed FinOps dashboards, reservation-utilisation reports, and budget-burn alerts without scraping the cost portal.

Use Cases

Patterns agents use ConsumptionManagementClient API for, with concrete tasks.

★ Monthly EA cost reconciliation

Finance teams running an Azure Enterprise Agreement need to reconcile each billing period's spend against budget and against the prior month. The Consumption Management Client returns balance summaries, charges, and reservation transactions for a billing period in one workflow, which can be loaded into a warehouse and compared to the corporate forecast.

GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances and emit a CSV joining the balance with the billing period's reservation transactions.

Reservation purchase recommendations

Reserved Instances cut Azure VM cost by up to 72% but only when the SKU mix is right. The Consumption Management Client exposes recommendation endpoints that size purchases against the last 7, 30, or 60 days of metered usage, so a FinOps script can publish a refreshed recommendation list each week without manual analysis.

GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/microsoft.consumption/ReservationRecommendations with lookBackPeriod=Last30Days and emit the top 10 candidate purchases by saving.

Budget burn-down alerts

When a subscription is on a tight budget, teams need to see actual versus forecast in near real-time. Consumption Management's budget, charges, and forecast endpoints together let an agent compute current burn, compare against the configured budget, and fire an alert when the projected end-of-period spend will exceed the cap.

Fetch charges and forecasts for subscription 00000000-0000-0000-0000-000000000000 for the current billing period and trigger a Slack alert when forecast > budget * 0.9.

Marketplace cost attribution

AppSource and Marketplace charges often hide outside the main Azure cost report. Calling the marketplaces endpoint by billing period returns the list of third-party charges with subscription, resource group, and offer details, so they can be allocated back to the team that purchased them.

List Marketplace charges for billing period 202605 and group spend by resourceGroup and offerName.

Agent-driven FinOps automation through Jentic

An AI agent integrated through Jentic can run a daily FinOps loop — pulling balances, reservation utilisation, charges, and forecasts — and post a digest to a finance channel. Jentic's intent search exposes the right Consumption Management operation for each metric and the AAD token is held in the vault so the agent never sees raw credentials.

On a daily schedule, fetch reservation utilisation, charges, and forecast for the current billing period and post a structured summary to the finance Slack channel.

Key Endpoints

25 endpoints — jentic publishes the only available openapi specification for consumptionmanagementclient, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances

Get EA balance for the current billing period

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/balances

Get EA balance for a specific billing period

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationDetails

List reservation usage details

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationSummaries

List reservation utilisation summaries

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions

List reservation purchase transactions

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/microsoft.consumption/ReservationRecommendations

Get reservation purchase recommendations

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances

Get EA balance for the current billing period

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/balances

Get EA balance for a specific billing period

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationDetails

List reservation usage details

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationSummaries

List reservation utilisation summaries

GET

/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure AD tokens for Reader/Billing Reader scope are stored encrypted in the Jentic vault. Agents receive a scoped access token per query — refresh tokens never enter the agent context.

Intent-based discovery

Agents search by intent (for example 'azure reservation recommendations' or 'pull azure ea balance') and Jentic returns the matching consumption operation with its full input schema and pagination shape.

Time to first call

Direct integration: 2-3 days for AAD app registration, billing-account scope wiring, and pagination handling across 25 endpoints. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Cost Management Client

Newer cost analysis API with cross-cloud and budget rules

Choose Cost Management Client when the agent needs cost dimensions, ad-hoc query exports, or non-EA scopes (MCA, MPA, CSP)

Alternative

Commerce Management Client

Azure Stack equivalent for subscriber usage aggregates

Choose Commerce Management when the agent is operating on an Azure Stack stamp instead of public Azure EA

Complementary

Compute Management Client

Lists the VMs whose reservation usage and recommendations the consumption API reports on

Choose Compute Management when the agent needs to act on the recommendation (e.g. resize a VM) after consumption analysis

FAQs

Specific to using ConsumptionManagementClient API through Jentic.

Why is there no official OpenAPI spec for ConsumptionManagementClient?

Microsoft Azure does not publish a single consolidated OpenAPI specification for the Consumption Management API. Jentic generates and maintains this spec so that AI agents and developers can call ConsumptionManagementClient via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the ConsumptionManagementClient use?

It uses Azure Active Directory OAuth 2.0 with the implicit flow at https://login.microsoftonline.com/common/oauth2/authorize and the user_impersonation scope. The caller needs Reader or Billing Reader on the EA billing account. Through Jentic the AAD token is held in the encrypted vault.

Can I get reservation utilisation with the ConsumptionManagementClient?

Yes — call GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationSummaries for daily or monthly utilisation, and reservationDetails for per-instance breakdowns. Both accept a $filter on reservationOrderId and reservationId.

What are the rate limits for the ConsumptionManagementClient?

ARM applies subscription-level read throttling (typically 12,000 reads per hour per subscription). Consumption queries that span large billing accounts return paginated results via nextLink — follow the pagination rather than retrying the same call.

How do I generate reservation recommendations through Jentic?

Search Jentic for 'azure reservation recommendations', load the schema for GET /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/microsoft.consumption/ReservationRecommendations, and execute it with lookBackPeriod=Last30Days. Run pip install jentic to get the SDK.

Is the ConsumptionManagementClient free?

Calling the consumption API itself is free; you only need a Reader or Billing Reader role on the EA billing account. The data it returns describes Azure spend but the call does not add to it.