---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages"
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages

`GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/usages`

Get the usage for a subscription

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/LocationParameter` — unresolved $ref

## Response `200`

The request has succeeded.

- UsageListResult — The response containing the usage data
  - `value` Usage[] — The usage data.
    - `id` string — Id of the usage result
    - `unit` string — Unit of the usage result
    - `currentValue` integer — The current usage of the resource
    - `limit` integer — The maximum permitted usage of the resource.
    - `name` UsageName — The name object of the resource
      - `value` string — The name of the resource
      - `localizedValue` string — The localized name of the resource
  - `nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2017-08-01-preview) `540a7f5ef13b` — 3 warning
  - deleted the `path` request parameter `location`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `114fa0867ea1` — 3 warning
  - deleted the `path` request parameter `location`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `3b95c53f2960` — 3 breaking
  - added the new path request parameter `location`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `d623baae3494` — 1 info
  - api operation id `ContainerGroupUsage_List` removed and replaced with `Location_ListUsage`
- **2026-07-13** (2017-08-01-preview) `efa372c29666` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/containerinstance-microsoft-containerinstance-containerinsta/changes/subscriptions/:subscriptionId/providers/Microsoft.ContainerInstance/locations/:location/usages/get.md)

---

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