Dela via

Charges - List

  • Reference
Service:
Consumption
API Version:
2024-08-01

Lists the charges based for the defined scope.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/charges?api-version=2024-08-01
With optional parameters: 
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate={startDate}&endDate={endDate}&$filter={$filter}&$apply={$apply}

URI Parameters

Name In Required Type Description
scope
 path True

string

The scope associated with charges operations. This includes '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, and '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}' for EnrollmentAccount scope. For department and enrollment accounts, you can also add billing period to the scope using '/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}'. For e.g. to specify billing period at department scope use '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}'. Also, Modern Commerce Account scopes are '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for billingAccount scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope, and '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specific for partners.
api-version
 query True

string

Version of the API to be used with the client request. The current version is 2023-03-01.
$apply
 query

string

May be used to group charges for billingAccount scope by properties/billingProfileId, properties/invoiceSectionId, properties/customerId (specific for Partner Led), or for billingProfile scope by properties/invoiceSectionId.
$filter
 query

string

May be used to filter charges by properties/usageEnd (Utc time), properties/usageStart (Utc time). The filter supports 'eq', 'lt', 'gt', 'le', 'ge', and 'and'. It does not currently support 'ne', 'or', or 'not'. Tag filter is a key value pair string where key and value is separated by a colon (:).
endDate
 query

string

End date
startDate
 query

string

Start date

Responses

Name Type Description
200 OK

ChargesListResult

OK. The request has succeeded.
Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

ChangesForBillingPeriodByDepartment-Legacy
ChangesForBillingPeriodByEnrollmentAccount-Legacy
ChargesListByBillingAccount-Modern
ChargesListByBillingAccountGroupByBillingProfileId-Modern
ChargesListByBillingAccountGroupByCustomerId-Modern
ChargesListByBillingAccountGroupByInvoiceSectionId-Modern
ChargesListByBillingProfile-Modern
ChargesListByBillingProfileGroupByInvoiceSectionId-Modern
ChargesListByBillingProfileInvoiceSection-Modern
ChargesListByCustomer-Modern
ChargesListByDepartment-Legacy
ChargesListByInvoiceSectionId-Modern
ChargesListForEnrollmentAccount-Legacy

ChangesForBillingPeriodByDepartment-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChangesForBillingPeriodByEnrollmentAccount-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChargesListByBillingAccount-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-10-31

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-10-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": null,
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByBillingAccountGroupByBillingProfileId-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/billingProfileId))

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/123456/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/123456"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425"
      }
    }
  ]
}

ChargesListByBillingAccountGroupByCustomerId-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/customerId))

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "customerId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890",
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/123456/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "customerId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/123456",
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingAccountGroupByInvoiceSectionId-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/invoiceSectionId))

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789//billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingProfile-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/2460/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460",
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByBillingProfileGroupByInvoiceSectionId-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/invoiceSectionId))

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789//billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingProfileInvoiceSection-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-10-31

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-10-31",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567"
      }
    }
  ]
}

ChargesListByCustomer-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": null,
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByDepartment-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&$filter=usageStart eq '2018-04-01' AND usageEnd eq '2018-05-30'

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChargesListByInvoiceSectionId-Modern

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/invoiceSections/97531/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/invoiceSections/97531/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 12
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 0
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/invoiceSections/97531"
      }
    }
  ]
}

ChargesListForEnrollmentAccount-Legacy

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

Definitions

Name Description
amount

The amount plus currency .
ChargesListResult

Result of listing charge summary.
ErrorDetails

The details of the error.
ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Some Error responses:

  • 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the "x-ms-ratelimit-microsoft.consumption-retry-after" header.

  • 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the "Retry-After" header.

  • 504 Gateway Timeout - Service timed out while processing the request. Reduce the date range in the request, if possible.
LegacyChargeSummary

Legacy charge summary.
ModernChargeSummary

Modern charge summary.

amount

The amount plus currency .

Name Type Description
currency

string

Amount currency.
value

number

Amount.

ChargesListResult

Result of listing charge summary.

Name Type Description
value ChargeSummary[]:

The list of charge summary

ErrorDetails

The details of the error.

Name Type Description
code

string

Error code.
message

string

Error message indicating why the operation failed.

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Some Error responses:

  • 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the "x-ms-ratelimit-microsoft.consumption-retry-after" header.

  • 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the "Retry-After" header.

  • 504 Gateway Timeout - Service timed out while processing the request. Reduce the date range in the request, if possible.

Name Type Description
error

ErrorDetails

The details of the error.

LegacyChargeSummary

Legacy charge summary.

Name Type Description
eTag

string

eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
id

string

Resource Id.
kind string:

legacy

Specifies the kind of charge summary.
name

string

Resource name.
properties.azureCharges

number

Azure Charges.
properties.azureMarketplaceCharges

number

Marketplace Charges.
properties.billingPeriodId

string

The id of the billing period resource that the charge belongs to.
properties.chargesBilledSeparately

number

Charges Billed separately.
properties.currency

string

Currency Code
properties.usageEnd

string

Usage end date.
properties.usageStart

string

Usage start date.
type

string

Resource type.

ModernChargeSummary

Modern charge summary.

Name Type Description
eTag

string

eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
id

string

Resource Id.
kind string:

modern

Specifies the kind of charge summary.
name

string

Resource name.
properties.azureCharges

amount

Azure Charges.
properties.billingAccountId

string

Billing Account Id
properties.billingPeriodId

string

The id of the billing period resource that the charge belongs to.
properties.billingProfileId

string

Billing Profile Id
properties.chargesBilledSeparately

amount

Charges Billed separately.
properties.customerId

string

Customer Id
properties.invoiceSectionId

string

Invoice Section Id
properties.isInvoiced

boolean

Is charge Invoiced
properties.marketplaceCharges

amount

Marketplace Charges.
properties.subscriptionId

string

Subscription guid.
properties.usageEnd

string

Usage end date.
properties.usageStart

string

Usage start date.
type

string

Resource type.