Microsoft Azure ConsumptionManagementClient
Browse all Azure APIs★ 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.
Use for: I need to retrieve last month's EA balance for billing account 12345, Get reservation utilisation details for the last 30 days, Generate a reservation recommendation across my subscription, List Marketplace charges for resource group prod-rg in May
Not supported: Does not provision resources, modify reservations, change budgets, or invoice customers — use for read-only Azure Enterprise Agreement consumption reporting only.
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.
Install Jentic One Beta
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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: 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 | sh2
Step 2: 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 instanceJentic 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
Query budgets, forecasts, and charges to surface burn-down and overspend warnings
Inspect price sheet details to model the unit cost of resource SKUs
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
List reservation purchase transactions
GET
/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/microsoft.consumption/ReservationRecommendations
Get reservation purchase recommendations
Why 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.
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.
GET STARTED