View and download your Azure usage and charges

You can download a daily breakdown of your Azure usage and charges in the Azure portal. You can also get your usage data using Azure CLI. Only certain roles have permission to get Azure usage information, like the Account Administrator or Enterprise Administrator. To learn more about getting access to billing information, see Manage access to Azure billing using roles.

If you have a Microsoft Customer Agreement (MCA), you must be a billing profile Owner, Contributor, Reader, or Invoice manager to view your Azure usage and charges. If you have a Microsoft Partner Agreement (MPA), only the Global Admin and Admin Agent role in the partner organization Microsoft can view and download Azure usage and charges.

Based on the type of subscription that you use, options to download your usage and charges vary.

Download usage from the Azure portal (.csv)

  1. Sign in to the Azure portal.
  2. Search for Cost Management + Billing.
    Screenshot shows Azure portal search for Cost Management + Billing.
  3. Depending on your access, you might need to select a Billing account or Billing profile.
  4. In the left menu, select Invoices under Billing.
  5. In the invoice grid, find the row of the billing period corresponding to the usage you want to download.
  6. Select the download icon or the ellipsis (...) on the right.
    Screenshot shows Cost Management + Billing Invoices page with download option.
  7. The Download pane opens on the right. Select Download from the Usage Details section.

Download usage for EA customers

To view and download usage data as a EA customer, you must be an Enterprise Administrator, Account Owner, or Department Admin with the view charges policy enabled.

  1. Sign in to the Azure portal.
  2. Search for Cost Management + Billing.
    Screenshot shows Azure portal search.
  3. If you have access to multiple billing accounts, select the billing scope for your EA billing account.
  4. Select Usage + charges.
  5. For the month you want to download, select Download.
    Screenshot shows Cost Management + Billing Invoices page for E A customers.
  6. On the Download Usage + Charges page, under Usage Details, select the type of charges that you want to download from the list. Depending on your selection, the CSV file provides all charges (usage and purchases) including RI (reservation) purchases. Or, amortized charges (usage and purchases) including reservation purchases. Screenshot showing the Usage Details charge type selection to download.
  7. Select Prepare document.
  8. It could take a while for Azure to prepare your download, depending on your monthly usage. When it's ready for download, select Download csv.

Download usage for your Microsoft Customer Agreement

To view and download usage data for a billing profile, you must be a billing profile Owner, Contributor, Reader, or Invoice manager.

Download usage for billed charges

  1. Search for Cost Management + Billing.
  2. Select a billing profile.
  3. Select Invoices.
  4. In the invoice grid, find the row of the invoice corresponding to the usage you want to download.
  5. Click on the ellipsis (...) at the end of the row.
  6. In the download context menu, select Azure usage and charges.

Download usage for open charges

You can also download month-to-date usage for the current billing period, meaning the charges have not been billed yet.

  1. Search for Cost Management + Billing.
  2. Select a billing profile.
  3. In the Overview blade, click Download Azure usage and charges.

Download usage for pending charges

If you have a Microsoft Customer Agreement, you can download month-to-date usage for the current billing period. These usage charges that have not been billed yet.

  1. Sign in to the Azure portal.
  2. Search for Cost Management + Billing.
  3. Select a billing profile. Depending on your access, you might need to select a billing account first.
  4. In the Overview area, find the download links beneath the recent charges.
  5. Select Download usage and prices.

Get usage data with Azure CLI

Start by preparing your environment for the Azure CLI:

  • Use the Bash environment in Azure Cloud Shell.

    Launch Cloud Shell in a new window

  • If you prefer, install the Azure CLI to run CLI reference commands.

    • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For additional sign-in options, see Sign in with the Azure CLI.

    • When you're prompted, install Azure CLI extensions on first use. For more information about extensions, see Use extensions with the Azure CLI.

    • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

After you sign in, use the az costmanagement query command to query month-to-date usage information for your subscription:

az costmanagement query --timeframe MonthToDate --type Usage --dataset-aggregation '{\"totalCost\":{\"name\":\"PreTaxCost\",\"function\":\"Sum\"}}' --dataset-grouping name="ResourceGroup" type="Dimension"
   --scope "subscriptions/00000000-0000-0000-0000-000000000000"

You can also narrow the query by using the --dataset-filter parameter or other parameters:

'{\"totalCost\":{\"name\":\"PreTaxCost\",\"function\":\"Sum\"}}' --dataset-grouping name="ResourceGroup" type="Dimension"
   --scope "subscriptions/00000000-0000-0000-0000-000000000000" --dataset-filter "{\"and\":[{\"or\":[{\"dimension\":{\"name\":\"ResourceLocation\",\"operator\":\"In\",\"values\":[\"East US\",\"West Europe\"]}},{\"tag\":{\"name\":\"Environment\",\"operator\":\"In\",\"values\":[\"UAT\",\"Prod\"]}}]},{\"dimension\":{\"name\":\"ResourceGroup\",\"operator\":\"In\",\"values\":[\"API\"]}}]}"

The --dataset-filter parameter takes a JSON string or @json-file.

You also have the option of using the az costmanagement export commands to export usage data to an Azure storage account. You can download the data from there.

  1. Create a resource group or use an existing resource group. To create a resource group, run the az group create command:

    az group create --name TreyNetwork --location "East US"
    
  2. Create a storage account to receive the exports or use an existing storage account. To create an account, use the az storage account create command:

    az storage account create --resource-group TreyNetwork --name cmdemo
    
  3. Run the az costmanagement export create command to create the export:

    az costmanagement export create --name DemoExport --type Usage \
    --scope "subscriptions/00000000-0000-0000-0000-000000000000" --storage-account-id cmdemo \
    --storage-container democontainer --timeframe MonthToDate --storage-directory demodirectory
    

Need help? Contact us.

If you have questions or need help, create a support request.

Next steps

To learn more about your invoice and usage charges, see:

If you have a Microsoft Customer Agreement, see: