---
title: "Get the number of iot hubs in the subscription"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Devices/usages"
tags: ["GET"]
---

# Get the number of iot hubs in the subscription

`GET /subscriptions/{subscriptionId}/providers/Microsoft.Devices/usages`

Get the number of free and paid iot hubs in the subscription

## Parameters

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

## Response `200`

The request has succeeded.

- UserSubscriptionQuotaListResult — Json-serialized array of User subscription quota response
  - `value` UserSubscriptionQuota[] — The UserSubscriptionQuota items on this page
    - `id` string — IotHub type id
    - `type` string — Response type
    - `unit` string — Unit of IotHub type
    - `currentValue` integer — Current number of IotHub type
    - `limit` integer — Numerical limit on IotHub type
    - `name` Name — Name of Iot Hub type
      - `value` string — IotHub type
      - `localizedValue` string — Localized value of name
  - `nextLink` string — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

---

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