---
title: "Get acquired numbers and limits for a resource."
method: GET
path: "/administration/resources/{resourceId}/telephone-number-summary"
tags: ["ACS Tiering"]
---

# Get acquired numbers and limits for a resource.

`GET /administration/resources/{resourceId}/telephone-number-summary`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/administration/resources/{resourceId}/telephone-number-summary`
- Auth: none declared

## Path parameters

- `resourceId` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `200`

Success

- object
  - `assetDetails` AssetDetails[], required: AssetDetails Array
    - `numberType` string[]: Array defining the number type of the phone number.
    - `resourceAcquiredCount` integer: Number of phone numbers that the resource has.
    - `subscriptionAcquiredCount` integer: Number of phone numbers that the subscription that the resource belongs to has.
    - `aadTenantAcquiredCount` integer: Number of phone numbers that the AAD tenant that the resource belongs to has.
    - `tierInfo` object: Tier specific info.
      - `scope` string: The level at which the tiering properties in the TierInfo are for
      - `allowed` integer: Number of phone numbers allowed that can change based on scope where scope can be (resource, subscription or tenant).
      - `acquired` integer: Number of phone numbers acquired that can change based on scope where scope can be (resource, subscription or tenant).
      - `balance` integer: Difference between allowed and acquired amount.
      - `limit` string: The standing of a customer to determine if they able to purchase more phone numbers.

## Other responses

- `default`: Failure

---

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