Microsoft Azure Azure Reservation
Browse all Azure APIs★ Only Publicly Available OpenAPI DocumentFinanceExpense Managementoauth214 EndpointsREST
For Agents
Calculate Azure reservation prices, list reservation orders, split or merge reservations, and update the scopes a reservation applies to so an agent can manage Azure committed-use discounts.
Use for: Calculate the price of a 1-year VM reservation in East US, List all Azure reservation orders in my tenant, I want to split a reservation into two smaller reservations, Merge two existing reservations into a single reservation
Not supported: Does not handle savings plans, marketplace purchases, or detailed billing line items - use for Microsoft.Capacity reservation order, reservation, and pricing operations only.
Jentic publishes the only available OpenAPI specification for Azure Reservation, keeping it validated and agent-ready. The API manages Microsoft.Capacity reservation orders and the individual reservations within them, the discounted commitment instruments that Azure customers buy to reduce VM, SQL, and other resource costs. It supports calculating prices, listing and reading reservation orders, splitting and merging reservations, updating their applied scopes, and reading revision history.
Install Jentic One Beta
Connect the Azure Reservation to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Azure Reservation, 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fazure-reservation" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fazure.com%2Fazure-reservation" | 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 Azure Reservation API.
Calculate the price of a prospective Azure reservation purchase before committing
List every reservation order in a tenant and inspect a single order with its child reservations
Split a reservation into smaller reservations or merge several reservations into one
Update the applied scopes of a reservation so it covers a different subscription or shared scope
List the available scopes a reservation can apply to before changing its assignment
Read the revision history of a reservation order to audit every change
Use Cases
Patterns agents use Azure Reservation API for, with concrete tasks.
★ Price a Reservation Before Purchase
Run a what-if calculation on the cost of a prospective Azure reservation before issuing a purchase order. POST to /providers/Microsoft.Capacity/calculatePrice with the SKU, region, term, and quantity, and the response returns the upfront and monthly pricing alongside the projected discount versus pay-as-you-go. This lets finance teams model commitment scenarios without contacting sales.
Call calculatePrice for a 1-year Standard_D2s_v3 reservation in East US with quantity 5 and return the upfront price and monthly equivalent
Split or Merge Reservations to Match Workloads
Split a single reservation into smaller units or merge several into one as workloads grow or consolidate. The split action under /reservationOrders/{id}/split breaks a reservation into N child reservations; merge under /reservationOrders/{id}/merge combines reservation ids back into one. Both preserve the original commitment term and avoid cancellation fees, so an agent can rebalance commitments throughout the year.
Split reservation 'res-123' inside reservation order 'order-abc' into two reservations of quantity 3 and 2 respectively
Update Reservation Scope for Shared Coverage
Change a reservation from Single subscription scope to Shared so the discount applies across every subscription in the tenant, or restrict it back to a Single scope when ownership boundaries change. PATCH to /reservationOrders/{orderId}/reservations/{reservationId} accepts the appliedScopeType and appliedScopes list, and availableScopes returns the candidate subscriptions before assignment. This lets centralised FinOps teams reassign coverage as billing structures evolve.
Update reservation 'res-123' in order 'order-abc' to appliedScopeType=Shared so it covers every subscription in the tenant
Agent-Driven Reservation Audit via Jentic
An AI agent uses Jentic to enumerate every reservation order in a tenant, walk each order's reservations, and compare their applied scopes and revision history against a FinOps policy. The agent searches Jentic for 'list azure reservation orders', loads the schema, and chains the response into the per-order reservations and revisions endpoints. Azure AD tokens are sourced from your Jentic One instance per call.
Search Jentic for 'list azure reservation orders', list every order, then for each order list reservations and revisions and emit an audit report flagging any reservation whose applied scope differs from policy
Key Endpoints
14 endpoints — jentic publishes the only available openapi specification for azure reservation, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/providers/Microsoft.Capacity/calculatePrice
Calculate the price of a prospective reservation purchase
GET
/providers/Microsoft.Capacity/reservationOrders
List all reservation orders
GET
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}
Get a reservation order
GET
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations
List reservations inside an order
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/split
Split a reservation into smaller reservations
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/merge
Merge reservations into a single reservation
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}/availableScopes
List available scopes for a reservation
POST
/providers/Microsoft.Capacity/calculatePrice
Calculate the price of a prospective reservation purchase
GET
/providers/Microsoft.Capacity/reservationOrders
List all reservation orders
GET
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}
Get a reservation order
GET
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations
List reservations inside an order
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/split
Split a reservation into smaller reservations
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/merge
Merge reservations into a single reservation
POST
/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}/availableScopes
List available scopes for a reservation
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Azure Reservation by hand means registering an Azure AD app, minting tokens for https://management.azure.com/, and polling the long-running split and merge operations while handling ARM throttling and paging yourself. Through Jentic you install once, import Azure Reservation from the API Directory, store the Azure AD credential once, and your agent calls it.
Permission scoping
The reservation order id travels in the URL path (/reservationOrders/{reservationOrderId}/...), so a rule can pin your agent to one reservation order: it can read its reservations and revisions and nothing else. You choose the operations it may call, so ones like splitting, merging, or changing the applied scope of a reservation are not included unless you add them.
Credential isolation
Your Azure AD credential is stored once, encrypted, by your own Jentic One instance and exchanged for a short-lived bearer token at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'calculate an Azure reservation price' or 'list azure reservation orders', and Jentic returns the matching Microsoft.Capacity operation with its input schema so the agent calls the right endpoint without browsing the ARM reference.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Azure Reservation API through Jentic.
Why is there no official OpenAPI spec for Azure Reservation?
Microsoft Azure does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Azure Reservation via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Azure Reservation API use?
The API uses Azure Active Directory OAuth 2.0 (the azure_auth scheme) with the user_impersonation scope on https://management.azure.com/. Through Jentic, the bearer token is fetched from your Jentic One instance and injected at call time so the agent never sees the raw client secret.
Can I split a reservation without losing the original term?
Yes. POST to /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/split with the reservation id and the desired quantities. The new child reservations preserve the original term and start date; no cancellation fee applies.
What are the rate limits for the Azure Reservation API?
The spec does not declare per-API limits; calls are throttled by Azure Resource Manager's per-tenant budget for read and write operations on Microsoft.Capacity. On HTTP 429, honour the Retry-After header before retrying.
How do I list every reservation order in my tenant through Jentic?
Search Jentic for 'list azure reservation orders', load the schema for GET /providers/Microsoft.Capacity/reservationOrders, and execute it. Jentic injects the Azure AD bearer token automatically; the agent only handles the response paging.
Is the Azure Reservation API free?
Control plane calls are free. Reservations themselves are paid contracts billed upfront or monthly, with the reservation discount applied to matching resource usage on the subscriptions in scope.
Can I limit what my agent is allowed to do with the Azure Reservation API?
Yes. Because you self-host Jentic One, your own rules decide which Microsoft.Capacity operations and which Azure AD credential the agent may use. Since the reservation order id travels in the URL path, you can pin the agent to a single reservation order so it only reads that order's reservations and revisions and nothing else. Read-only operations like listing orders or calculating a price can be allowed while write actions such as splitting, merging, or changing a reservation's applied scope stay excluded unless you add them.
GET STARTED