---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/usages"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/usages"
tags: ["CognitiveServicesAccounts"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/usages

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/usages`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/usages`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Get usages for the requested Cognitive Services account

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `accountName` string, required

## Query parameters

- `api-version` string, required
- `$filter` string

## Response `200`

Azure operation completed successfully.

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

## Changes

- **2026-07-13** (2016-02-01-preview) `d0eb21b3d2a7`: 3 breaking
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2016-02-01-preview) `10ba71accb6e`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2016-02-01-preview) `76a438c3d97a`: 1 info
  - api operation id `Accounts_GetUsages` removed and replaced with `Accounts_ListUsages`
- **2026-07-13** (2016-02-01-preview) `a945a4b99f00`: 1 info
  - endpoint added
- **2017-12-28** (2016-02-01-preview) `9fddc284caf8`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.CognitiveServices/accounts/:accountName/usages/get.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices.md) - [All operations](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/revisions/d0eb21b3d2a7?raw)
