Reporting APIs for Enterprise customers - Balance and Summary

The Balance and Summary API offers a monthly summary of information on balances, new purchases, Azure Marketplace service charges, adjustments, and overage charges.

Request

Common header properties that need to be added are specified here. If a billing period is not specified, then data for the current billing period is returned.

Method Request URI
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/balancesummary
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary
Note

To use the preview version of API, replace v2 with v1 in the above URL.

Response

    {
        "id": "enrollments/100/billingperiods/201507/balancesummaries",
        "billingPeriodId": 201507,
        "currencyCode": "USD",
        "beginningBalance": 0,
        "endingBalance": 1.1,
        "newPurchases": 1,
        "adjustments": 1.1,
        "utilized": 1.1,
        "serviceOverage": 1,
        "chargesBilledSeparately": 1,
        "totalOverage": 1,
        "totalUsage": 1.1,
        "azureMarketplaceServiceCharges": 1,
        "newPurchasesDetails": [
            {
            "name": "",
            "value": 1
            }
        ],
        "adjustmentDetails": [
            {
            "name": "Promo Credit",
            "value": 1.1
            },
            {
            "name": "SIE Credit",
            "value": 1.0
            }
        ]
    }

Response property definitions

Property Name Type Description
id string The unique Id for a specific billing period and enrollment
billingPeriodId string The billing period Id
currencyCode string The currency code
beginningBalance decimal The beginning balance for the billing period
endingBalance decimal The ending balance for the billing period (for open periods this will be updated daily)
newPurchases decimal Total new purchase amount
adjustments decimal Total adjustment amount
utilized decimal Total Commitment usage
serviceOverage decimal Overage for Azure services
chargesBilledSeparately decimal Charges Billed separately
totalOverage decimal serviceOverage + chargesBilledSeparately
totalUsage decimal Azure service commitment + total Overage
azureMarketplaceServiceCharges decimal Total charges for Azure Marketplace
newPurchasesDetails JSON string array of Name Value pairs List of new purchases
adjustmentDetails JSON string array of Name Value pairs List of Adjustments (Promo credit, SIE credit etc.)


See also