---
title: "Retrieve information about what users on an account are using the specified telephone number."
method: GET
path: "/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/usages"
tags: ["Telephone Number"]
---

# Retrieve information about what users on an account are using the specified telephone number.

`GET /v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/usages`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/usages`
- Auth: API key in header `X-AUTH-TOKEN`

Use to retrieve usages of a specific telephone number on an account. <span hidden>Refer to <a href="tnInventory.html#retrieve-tn-usages">Search Partition for Telephone Number</a> for more information.</span>

## Path parameters

- `accountId` string, required
- `partitionId` string, required
- `tn` string, required

## Response `200`

Successful operation

- TelephoneNumberUsagesX
  - `partitionId` string
  - `accountId` string
  - `phoneNumber` string
  - `users` string[]

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/cb514a0728ed?raw)