Track Microsoft Customer Agreement Azure credit balance
Article
You can check the Azure credit balance for your billing account for a Microsoft Customer Agreement in the Azure portal or through REST APIs.
In the billing account for a Microsoft Customer Agreement, credits are assigned to a billing profile. Each billing profile has its own credits that are automatically applied to the charges on its invoice. You must have an owner, contributor, reader, or invoice manager role on the billing profile or owner, contributor, or reader role on the billing account to view Azure credit balance for a billing profile. To learn more about the roles, see Understand Microsoft Customer Agreement administrative roles in Azure.
Note
New credit can take up to 24 hours to appear in the Azure portal. If you get new credit and can't see it in the portal, allow 24 hours for it to appear.
In the billing scopes page, select the billing account for which you want to track the credit balance. The billing account should be of type Microsoft Customer Agreement.
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.
Select Payment methods from the left-hand side and then select Azure credits.
The Azure credits page has the following sections:
Balance
The balance section displays the summary of your Azure credit balance.
Term
Definition
Estimated balance
Estimated amount of credits you have after considering all billed and pending transactions
Current balance
Amount of credits as of your last invoice. It doesn't include any pending transactions
When your estimated balance drops to 0, you are charged for all your usage, including for products that are eligible for credits.
Credits list
The credits list section displays the list of Azure credits.
Term
Definition
Source
The acquisition source of the credit
Start date
The date when you acquired the credit
Expiration date
The date when the credit expires
Current balance
The balance as of your last invoice
Original amount
The original amount of credit
Status
The current status of credit. Status can be active, used, expired, or expiring
Transactions
The transactions section displays all transactions that affected your credits balance.
Term
Definition
Transaction date
The date when the transaction happened
Description
A description of the transaction
Amount
The amount of transaction
Balance
The balance after the transaction
Note
If you don't see Azure credits in the payment methods page, either you don't have credits or you have not selected the right scope. Select the billing account which has credits or one of its billing profiles. To learn how to change scopes, see Switch billing scopes in the Azure portal.
If you are viewing Azure credits at the billing account scope and the billing account has more than one billing profiles, the Azure credits page will show a table with a summary of Azure credits for each billing profile. Select a billing profile from the list, select payment methods and then Azure credits to view details for a billing profile.
You can use the Azure Billing and the Consumption APIs to programmatically get the credit balance for your billing account.
The examples shown below use REST APIs. Currently, PowerShell and Azure CLI are not supported.
Find billing profiles you have access to
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?$expand=billingProfiles&api-version=2019-10-01-preview
The API response returns a list of billing accounts and their billing profiles.
Use the displayName property of the billing profile to identify the billing profile for which you want to check the credit balance. Copy the id of the billing profile. For example, if you want to check credit balance for Development billing profile, you'd copy /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx. Paste this value somewhere so that you can use it in the next step.
Get Azure credit balance
Make the following request, replacing <billingProfileId> with the id copied in the first step (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx).
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/credits/balanceSummary?api-version=2019-10-01
The API response returns estimated and current balance for the billing profile.
The estimated amount of credits you have after considering all billed and pending transactions.
currentBalance
The amount of credits as of your last invoice. It doesn't include any pending transactions.
pendingCreditAdjustments
The adjustments like refunds that are not yet invoiced.
expiredCredit
The credit that expired since your last invoice.
pendingEligibleCharges
The credit eligible charges that are not yet invoiced.
Get list of credits
Make the following request, replacing <billingProfileId> with the id copied in the first step (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx).
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/lots?api-version=2019-10-01
The API response returns lists of Azure credits for a billing profile.
The source that defines who how acquired the credit.
startDate
The date when the credit became active.
expirationDate
The date when the credit expires.
poNumber
The purchase order number of the invoice on which the credit was billed.
Get transactions that affected credit balance
Make the following request, replacing <billingProfileId> with the id copied in the first step (providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx). You would need to pass a startDate and an endDate to get transactions for your required duration.
GET https://management.azure.com<billingProfileId>/providers/Microsoft.Consumption/events?api-version=2019-10-01&startDate=2018-10-01T00:00:00.000Z&endDate=2019-10-11T12:00:00.000Z?api-version=2019-10-01
The API response returns all transactions that affected the credit balance for your billing profile.
The invoice number of the invoice on which the transaction is billed. It will be empty for pending transaction.
How credits are used
In a billing account for a Microsoft customer agreement, you use billing profiles to manage your invoices and payment methods. A monthly invoice is generated for each billing profile and you use the payment methods to pay the invoice.
You assign credits that you acquire to a billing profile. When an invoice is generated for the billing profile, credits are automatically applied to the total charges to calculate the amount that you need to pay. You pay the remaining amount with your payment methods like check/ wire transfer or credit card.
Products that aren't covered by Azure credits
The following products aren't covered by your Azure credits. You're charged for using these products regardless of your credit balance:
Canonical
Citrix XenApp Essentials
Citrix XenDesktop
Registered User
Openlogic
Remote Access Rights XenApp Essentials Registered User
Ubuntu Advantage
Visual Studio Enterprise (Monthly)
Visual Studio Enterprise (Annual)
Visual Studio Professional (Monthly)
Visual Studio Professional (Annual)
Azure Marketplace products
Azure support plans
Check access to a Microsoft Customer Agreement
To check the agreement type to determine whether you have access to a billing account for a Microsoft Customer Agreement, follow these steps:
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.
Need help? Contact support.
If you need help, contact support to get your issue resolved quickly.
Learn how to check free service usage in the Azure portal. There's no charge for services included in a free account unless you go over the service limits.