---
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

## Path parameters

- `subscriptionId` string, required
- `location` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK

- UsageListResult — The response containing the usage data
  - `value` Usage[]
    - `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` object — The name object of the resource
      - `value` string — The name of the resource
      - `localizedValue` string — The localized name of the resource

## Changes

- **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/efa372c29666/schema)