# Azure Consumption management API

> Azure Consumption management API on Apizie: 32 endpoints (Lists all budgets for the defined scope., Gets the budget for the scope by budget name., The operation to create or update a budget. You can optionally provide an eTag if desired as a form of…, The operation to delete a budget., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-arm-consumption/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-arm-consumption`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-arm-consumption
- OpenAPI: https://apizie.tech/api/cloud/azure-arm-consumption/openapi.json

Azure Resource Manager API for Consumption: manage these Azure resources in your subscription with a Microsoft Entra access token.

## Endpoints

### Lists all budgets for the defined scope.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |

### Gets the budget for the scope by budget name.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| budgetName | string | yes | Budget Name. |

### The operation to create or update a budget. You can optionally provide an eTag if desired as a form of…
`POST https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| budgetName | string | yes | Budget Name. |
| body | object | yes | JSON request body |

### The operation to delete a budget.
`POST https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| budgetName | string | yes | Budget Name. |

### Lists the charges based for the defined scope.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/charges-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| startDate | string | no | Start date |
| endDate | string | no | End date |
| $filter | string | no | May be used to filter charges by properties/usageEnd (Utc time), properties/usageStart (Utc time). The filter supports 'eq', 'lt', 'gt',… |
| $apply | string | no | May be used to group charges for billingAccount scope by properties/billingProfileId, properties/invoiceSectionId, properties/customerId… |

### Lists the marketplaces for a scope at the defined scope. Marketplaces are available via this API only for…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/marketplaces-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| $filter | string | no | May be used to filter marketplaces by properties/usageEnd (Utc time), properties/usageStart (Utc time), properties/resourceGroup,… |
| $top | integer | no | May be used to limit the number of results to the most recent N marketplaces. |
| $skiptoken | string | no | Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of… |

### Lists the reservations details for provided date range. Note: ARM has a payload size limit of 12MB, so…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-details-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| resourceScope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| startDate | string | no | Start date. Only applicable when querying with billing profile |
| endDate | string | no | End date. Only applicable when querying with billing profile |
| $filter | string | no | Filter reservation details by date range. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge'. Not… |
| reservationId | string | no | Reservation Id GUID. Only valid if reservationOrderId is also provided. Filter to a specific reservation |
| reservationOrderId | string | no | Reservation Order Id GUID. Required if reservationId is provided. Filter to a specific reservation order |

### Details of a reservation recommendation for what-if analysis of reserved instances.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservation-recommendation-details-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| resourceScope | string | yes | The scope associated with reservation recommendation details operations. This includes '/subscriptions/{subscriptionId}/' for subscription… |
| scope | string | yes | Scope of the reservation. |
| region | string | yes | Used to select the region the recommendation should be generated for. |
| term | string | yes | Specify length of reservation recommendation term. |
| lookBackPeriod | string | yes | Filter the time period on which reservation recommendation results are based. |
| product | string | yes | Filter the products for which reservation recommendation results are generated. Examples: Standard_DS1_v2 (for VM),… |
| $filter | string | no | Used to filter reservation recommendation details by: properties/subscriptionId can be specified for billing account and billing profile… |
| managementGroupId | string | no | Specify the management group ID. Required when recommendation scope is 'ManagementGroup'. |

### List of recommendations for purchasing reserved instances.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservation-recommendations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| resourceScope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| $filter | string | no | May be used to filter reservationRecommendations by: properties/scope with allowed values ['Single', 'Shared'] and default value 'Single';… |

### Lists the reservations summaries for the defined scope daily or monthly grain. Note: ARM has a payload size…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-summaries-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| resourceScope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| grain | string | yes | Can be daily or monthly |
| startDate | string | no | Start date. Only applicable when querying with billing profile |
| endDate | string | no | End date. Only applicable when querying with billing profile |
| $filter | string | no | Required only for daily grain. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge'. Not applicable… |
| reservationId | string | no | Reservation Id GUID. Only valid if reservationOrderId is also provided. Filter to a specific reservation |
| reservationOrderId | string | no | Reservation Order Id GUID. Required if reservationId is provided. Filter to a specific reservation order |

### Get all available tag keys for the defined scope
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/tags-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |

### Lists the usage details for the defined scope. Usage details are available via this API only for May 1, 2014…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/usage-details-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The fully qualified Azure Resource manager identifier of the resource. |
| $expand | string | no | May be used to expand the properties/additionalInfo or properties/meterDetails within a list of usage details. By default, these fields… |
| $filter | string | no | May be used to filter usageDetails by properties/resourceGroup, properties/resourceName, properties/resourceId, properties/chargeType,… |
| $skiptoken | string | no | Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of… |
| $top | integer | no | May be used to limit the number of results to the most recent N usageDetails. |
| metric | string | no | Allows to select different type of cost/usage records. |

### Gets the balances for a scope by billing period and billingAccountId. Balances are available via this API…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/balances-get-for-billing-period-by-billing-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingPeriodName | string | yes | Billing Period Name. |

### Generates the pricesheet for the provided billing period asynchronously based on the enrollment id
`POST https://apizie.tech/v1/cloud:azure-arm-consumption/price-sheet-download-by-billing-account-period` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingPeriodName | string | yes | Billing Period Name. |

### The credit summary by billingAccountId and billingProfileId.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/credits-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingProfileId | string | yes | Azure Billing Profile ID. |

### Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/events-list-by-billing-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingProfileId | string | yes | Azure Billing Profile ID. |
| startDate | string | yes | Start date |
| endDate | string | yes | End date |

### Lists all Azure credits for a billing account or a billing profile. The API is only supported for Microsoft…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/lots-list-by-billing-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingProfileId | string | yes | Azure Billing Profile ID. |

### List of transactions for reserved instances on billing profile scope. The refund transactions are posted…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservation-transactions-list-by-billing-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| billingProfileId | string | yes | Azure Billing Profile ID. |
| $filter | string | no | Filter reservation transactions by date range. The properties/EventDate for start date and end date. The filter supports 'le' and 'ge'.… |

### Lists all Azure credits for a customer. The API is only supported for Microsoft Partner Agreements (MPA)…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/lots-list-by-customer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| customerId | string | yes | Customer ID |
| $filter | string | no | May be used to filter the lots by Status, Source etc. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. Tag filter is a key… |

### Gets the balances for a scope by billingAccountId. Balances are available via this API only for May 1, 2014…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/balances-get-by-billing-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |

### Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/events-list-by-billing-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| $filter | string | no | May be used to filter the events by lotId, lotSource etc. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not… |

### Lists all Microsoft Azure consumption commitments for a billing account. The API is only supported for…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/lots-list-by-billing-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| $filter | string | no | May be used to filter the lots by Status, Source etc. The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently… |

### List of transactions for reserved instances on billing account scope. Note: The refund transactions are…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservation-transactions-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | BillingAccount ID |
| $filter | string | no | Filter reservation transactions by date range. The properties/EventDate for start date and end date. The filter supports 'le' and 'ge'.… |
| useMarkupIfPartner | boolean | no | Applies mark up to the transactions if the caller is a partner. |
| previewMarkupPercentage | number | no | Preview markup percentage to be applied. |

### Lists the reservations details for provided date range. Note: ARM has a payload size limit of 12MB, so…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-details-list-by-reservation-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderId | string | yes | Order Id of the reservation |
| $filter | string | yes | Filter reservation details by date range. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge' |

### Lists the reservations summaries for daily or monthly grain. Note: ARM has a payload size limit of 12MB, so…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-summaries-list-by-reservation-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderId | string | yes | Order Id of the reservation |
| grain | string | yes | Can be daily or monthly |
| $filter | string | no | Required only for daily grain. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge' |

### Lists the reservations details for provided date range. Note: ARM has a payload size limit of 12MB, so…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-details-list-by-reservation-order-and-reservati` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderId | string | yes | Order Id of the reservation |
| reservationId | string | yes | Id of the reservation |
| $filter | string | yes | Filter reservation details by date range. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge' |

### Lists the reservations summaries for daily or monthly grain. Note: ARM has a payload size limit of 12MB, so…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/reservations-summaries-list-by-reservation-order-and-reserva` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderId | string | yes | Order Id of the reservation |
| reservationId | string | yes | Id of the reservation |
| grain | string | yes | Can be daily or monthly |
| $filter | string | no | Required only for daily grain. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge' |

### List the operations for the provider
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Provides the aggregate cost of a management group and all child management groups by specified billing period
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/aggregated-cost-get-for-billing-period-by-management-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| managementGroupId | string | yes | Order Id of the reservation |
| billingPeriodName | string | yes | Billing Period Name. |

### Provides the aggregate cost of a management group and all child management groups by current billing period.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/aggregated-cost-get-by-management-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| managementGroupId | string | yes | Order Id of the reservation |
| $filter | string | no | Required only for daily grain. The properties/UsageDate for start date and end date. The filter supports 'le' and 'ge' |

### Get the price sheet for a scope by subscriptionId and billing period. Price sheet is available via this API…
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/price-sheet-get-by-billing-period` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. |
| billingPeriodName | string | yes | Billing Period Name. |
| $expand | string | no | May be used to expand the properties/meterDetails within a price sheet. By default, these fields are not included when returning price… |
| $skiptoken | string | no | Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of… |
| $top | integer | no | May be used to limit the number of results to the top N results. |

### Gets the price sheet for a subscription. Price sheet is available via this API only for May 1, 2014 or later.
`GET https://apizie.tech/v1/cloud:azure-arm-consumption/price-sheet-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. |
| $expand | string | no | May be used to expand the properties/meterDetails within a price sheet. By default, these fields are not included when returning price… |
| $skiptoken | string | no | Skiptoken is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of… |
| $top | integer | no | May be used to limit the number of results to the top N results. |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Azure Consumption management API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-arm-consumption/budgets-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Azure Consumption management API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure Consumption management itself also needs your own key from azure.com.

### Can AI agents use the Azure Consumption management API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-arm-consumption.

### What is the status of the Azure Consumption management API?
Needs your own provider key (bring your own key)