---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/locations/{location}/usages"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/locations/{location}/usages"
tags: ["Usages"]
---

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

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

Get usages for the requested subscription

## Query parameters

- `$filter` string

## Parameters

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

## Response `200`

The request has succeeded.

- UsageListResult — The response to a list usage request.
  - `nextLink` string — The link used to get the next page of Usages.
  - `value` Usage[] — The list of usages for Cognitive Service account.
    - `unit` 'Count' | 'Bytes' | 'Seconds' | 'Percent' | 'CountPerSecond' | 'BytesPerSecond' | 'Milliseconds' — The unit of the metric.
    - `name` MetricName — A metric name.
      - `value` string — The name of the metric.
      - `localizedValue` string — The friendly name of the metric.
    - `quotaPeriod` string — The quota period used to summarize the usage values.
    - `limit` number, double — Maximum value for this metric.
    - `currentValue` number, double — Current value for this metric.
    - `nextResetTime` string — Next reset time for current quota.
    - `status` 'Included' | 'Blocked' | 'InOverage' | 'Unknown' — Cognitive Services account quota usage status.
    - `scopeType` 'Regional' | 'Global' | 'DataZone' | 'Classic' — The quota scope that determines the level at which the quota is applied.
    - `scopeId` string, nullable — The scope identifier of the quota usage.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-microsoft-cognitiveservices.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-microsoft-cognitiveservices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-microsoft-cognitiveservices/revisions/691c4877e0b8/schema)