Track your Azure Consumption Commitment (MACC)

Article
06/20/2023

The Azure Consumption Commitment (MACC) is a contractual commitment that your organization may have made to Azure spend over time. If your organization has a MACC for a Microsoft Customer Agreement (MCA) billing account or an Enterprise Agreement (EA) billing account you can check important aspects of your commitment, including start and end dates, remaining commitment, and eligible spend in the Azure portal or through REST APIs.

MACC functionality in the Azure portal is only available for direct MCA and direct EA customers. A direct agreement is between Microsoft and a customer. An indirect agreement is one where a customer signs an agreement with a Microsoft partner.

In the scenario that a MACC commitment has been transacted prior to the expiration or completion of a prior MACC (on the same enrollment/billing account), actual decrement of a commitment will begin upon completion or expiration of the prior commitment. In other words, if you have a new MACC following the expiration or completion of an older MACC on the same enrollment or billing account, use of the new commitment starts when the old commitment expires or is completed.

Prerequisites

For an EA, the user needs to be an Enterprise administrator to view the MACC balance.
For an MCA, the user must be have the owner, contributor, or reader role on the billing account to view the MACC balance.

Sign in to the Azure portal.
Search for Cost Management + Billing.
In the billing scopes page, select the billing account for which you want to track the commitment. The billing account type must be Microsoft Customer Agreement for Microsoft Customer Agreement (MCA) customers or Enterprise Agreement for EA customers.

Note

Azure portal remembers the last billing scope that you access and displays the scope the next time you come to Cost Management + Billing page. You won't see the billing scopes page if you have visited Cost Management + Billing earlier. If so, check that you are in the right scope. If not, switch the scope to select the billing account for a Microsoft Customer Agreement.
Depending on your agreement type, do one of the following:
- For MCA customers, select Properties from the left-hand side and then select Azure Consumption Commitment (MACC).
- For EA customers, select Credits + Commitments in the left navigation menu, then select Azure Consumption Commitment (MACC).
The Azure Consumption Commitment (MACC) tab has the following sections.

Remaining commitment

The remaining commitment displays the remaining commitment amount since your last invoice.

Details

The Details section displays other important aspects of your commitment.

Term	Definition
ID	An identifier that uniquely identifies your MACC. This identifier is used to get your MACC information through REST APIs.
Purchase date	The date when you made the commitment.
Start date	The date when the commitment became effective.
End date	The date when the commitment expired.
Commitment amount	The amount that you’ve committed to spend on MACC-eligible products/services.
Status	The status of your commitment.

Your MACC can have one of the following statutes:

Active: MACC is active. Any eligible spend will contribute towards your MACC commitment.
Completed: You’ve completed your MACC commitment.
Expired: MACC is expired. Contact your Microsoft Account team for more information.
Canceled: MACC is canceled. New Azure spend won't contribute towards your MACC commitment.

Events

The Events section displays events (invoiced spend) that decremented your MACC commitment.

Term	Definition
Date	The date when the event happened
Description	A description of the event
Billing profile	The billing profile for which the event happened. The billing profile only applies to Microsoft Customer Agreements. If you have an EA enrollment, the Billing Profile isn't shown.
MACC decrement	The amount of MACC decrement from the event
Remaining commitment	The remaining MACC commitment after the event

You can use the Azure Billing and the Consumption APIs to programmatically get Azure Consumption Commitment (MACC) for your billing account.

The examples shown below use REST APIs. Currently, PowerShell and Azure CLI aren't supported. Example output is for Microsoft Customer Agreements, so output for Enterprise Agreements will differ.

Find billing accounts you have access to

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts?api-version=2020-05-01

The API response returns a list of billing accounts.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "name": "9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "type": "Microsoft.Billing/billingAccounts",
      "properties": {
        "displayName": "Contoso",
        "agreementType": "MicrosoftCustomerAgreement",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "hasReadAccess": true,
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "name": "9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "type": "Microsoft.Billing/billingAccounts",
      "properties": {
        "displayName": "Kayla Lewis",
        "agreementType": "MicrosoftCustomerAgreement",
        "accountStatus": "Active",
        "accountType": "Individual",
        "hasReadAccess": true,
      }
    }
  ]
}

Use the displayName property of the billing account to identify the billing account for which you want to track MACC. Copy the name of the billing account. For example, if you want to track MACC for Contoso billing account, you'd copy 9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx. Paste this value somewhere so that you can use it in the next step.

Get a list of Azure Consumption Commitments

Make the following request, replacing <billingAccountName> with the name copied in the first step (9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx).

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/lots?api-version=2021-05-01&$filter=source%20eq%20%27ConsumptionCommitment%27

The API response returns lists of MACCs for your billing account.

    {
    "value": [
      {
        "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "name": "G2021032459206000XXXX",
        "type": "Microsoft.Consumption/lots",
        "eTag": null,
        "properties": {
          "purchasedDate": "2021-03-24T16:26:46.0000000Z",
          "status": "Active",
          "originalAmount": {
            "currency": "USD",
            "value": 10000.0
          },
          "closedBalance": {
            "currency": "USD",
            "value": 9899.42
          },
          "source": "ConsumptionCommitment",
          "startDate": "2021-03-01T00:00:00.0000000Z",
          "expirationDate": "2024-02-28T00:00:00.0000000Z"
        }
      },
      {
        "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G1011082459206000XXXX",
        "name": "G1011082459206000XXXX",
        "type": "Microsoft.Consumption/lots",
        "eTag": null,
        "properties": {
          "purchasedDate": "2021-03-24T16:26:46.0000000Z",
          "status": "Complete",
          "originalAmount": {
            "currency": "USD",
            "value": 10000.0
          },
          "closedBalance": {
            "currency": "USD",
            "value": 0.00
          },
          "source": "ConsumptionCommitment",
          "startDate": "2020-03-01T00:00:00.0000000Z",
          "expirationDate": "2021-02-28T00:00:00.0000000Z"
        }
      }
    ]
  }

Element name	Description
`purchasedDate`	The date when the MACC was purchased.
`status`	The status of your commitment.
`originalAmount`	The original commitment amount.
`closedBalance`	The remaining commitment since the last invoice.
`source`	For MACC, the source will always be ConsumptionCommitment.
`startDate`	The date when the MACC became active.
`expirationDate`	The date when the MACC expires.

Your MACC can have one of the following statutes:

Active: MACC is active. Any eligible spend will contribute towards your MACC commitment.
Completed: You’ve completed your MACC commitment.
Expired: MACC is expired. Contact your Microsoft Account team for more information.
Canceled: MACC is canceled. New Azure spend won't contribute towards your MACC commitment.

Get events that affected MACC commitment

Make the following request, replacing <billingAccountName> with the name copied in the first step (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx). You would need to pass a startDate and an endDate to get events for your required duration.

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/events?api-version=2021-05-01&startDate=<startDate>&endDate=<endDate>&$filter=lotsource%20eq%20%27ConsumptionCommitment%27

The API response returns all events that affected your MACC commitment.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "name": "103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
        "billingProfileDisplayName": "Finance",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "lotSource": "ConsumptionCommitment",
        "transactionDate": "2021-05-05T00:09:13.0000000Z",
        "description": "Balance after invoice T00075XXXX",
        "charges": {
          "currency": "USD",
          "value": -100.0
        },
        "closedBalance": {
          "currency": "USD",
          "value": 9899.71
        },
        "eventType": "SettledCharges",
        "invoiceNumber": "T00075XXXX"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "name": "203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
        "billingProfileDisplayName": "Engineering",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "lotSource": "ConsumptionCommitment",
        "transactionDate": "2021-04-05T00:09:13.0000000Z",
        "description": "Balance after invoice T00074XXXX",
        "charges": {
          "currency": "USD",
          "value": -0.29
        },
        "closedBalance": {
          "currency": "USD",
          "value": 9999.71
        },
        "eventType": "SettledCharges",
        "invoiceNumber": "T00074XXXX"
      }
    }
  ]
}

Element name	Description
`billingProfileId`	The unique identifier for the billing profile for which the event happened.
`billingProfileDisplayName`	The display name for the billing profile for which the event happened.
`lotId`	The unique identifier for the MACC.
`lotSource`	It will be ConsumptionCommitment for MACC.
`transactionDate`	The date when the event happened.
`description`	The description of the event.
`charges`	The amount of MACC decrement.
`closedBalance`	The balance after the event.
`eventType`	Only SettledCharges events are supported for MACC.
`invoiceNumber`	The unique ID of the invoice whose charges decremented MACC.

Azure Services and Marketplace offers that are eligible for MACC

You can determine which Azure services and Marketplace offers are eligible for MACC decrement in the Azure portal.

Azure credits and MACC

If your organization received Azure credits from Microsoft, the consumption or purchases that are covered by credits won't contribute towards your MACC commitment.

If your organization purchased Azure Prepayment, the consumption or purchases that are covered by credits won't contribute towards your MACC commitment. However, the actual Prepayment purchase itself will decrement your MACC commitment.

For example, Contoso made a MACC commitment of $50,000 in May. In June, they purchased an Azure Prepayment of $10,000. The purchase will decrement their MACC commitment and the remaining commitment will be $40,000. In June, Contoso consumed $10,000 of Azure Prepayment-eligible services. The service charges will be covered by their Azure Prepayment; however, the service charges won’t decrement their MACC commitment. Once the Azure Prepayment is fully used, all Azure service consumption and other eligible purchases will decrement their MACC commitment.

Check access to a Microsoft Customer Agreement

Check the agreement type to determine whether you have access to a billing account for a Microsoft Customer Agreement.

Go to the Azure portal to check for billing account access. Search for and select Cost Management + Billing.
If you have access to just one billing scope, select Properties from the menu. You have access to a billing account for a Microsoft Customer Agreement if the billing account type is Microsoft Customer Agreement.
If you have access to multiple billing scopes, check the type in the billing account column. You have access to a billing account for a Microsoft Customer Agreement if the billing account type for any of the scopes is Microsoft Customer Agreement.