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

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK

- UserSubscriptionQuotaListResult — Json-serialized array of User subscription quota response
  - `value` UserSubscriptionQuota[]
    - `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

## Other responses

- `default` — DefaultErrorResponse

---

[API](https://skmtc.net/azure/apis/iothubclient.md) · [All operations](https://skmtc.net/azure/apis/iothubclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iothubclient/versions/a0bee5faaac7/schema)