---
title: "GET /{scope}/providers/Microsoft.Consumption/usageDetails"
method: GET
path: "/{scope}/providers/Microsoft.Consumption/usageDetails"
tags: ["UsageDetails"]
---

# GET /{scope}/providers/Microsoft.Consumption/usageDetails

`GET /{scope}/providers/Microsoft.Consumption/usageDetails`

Lists the usage details for the defined scope. Usage details are available via this API only for May 1, 2014 or later.

## Path parameters

- `scope` string, required

## Query parameters

- `$expand` string
- `$filter` string
- `$skiptoken` string
- `$top` integer
- `api-version` string, required
- `metric` 'actualcost' | 'amortizedcost' | 'usage'

## Response `200`

OK. The request has succeeded.

- UsageDetailsListResult — Result of listing usage details. It contains a list of available usage details in reverse chronological order by billing period.
  - `value` UsageDetail[] — The list of usage details.
    - `id` string — Resource Id.
    - `name` string — Resource name.
    - `type` string — Resource type.
    - `tags` object — Resource tags.
  - `nextLink` string — The link (url) to the next page of results.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/consumptionmanagementclient.md) · [All operations](https://skmtc.dev/azure/apis/consumptionmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/consumptionmanagementclient/revisions/f34618e34e72/schema)