# Alianza Telephone Number API

**Canonical:** https://apis.io/apis/alianza/alianza-telephone-number-api/  
**Provider:** Alianza — https://apis.io/providers/alianza/  
**Base URL:** https://api.alianza.com  
**Documentation:** https://developer.alianza.com/provisioning-api

Alianza Telephone Number API is one of 60 APIs that [Alianza](https://apis.io/providers/alianza/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Telephone Number. The published artifact set on APIs.io includes an OpenAPI specification.

The Telephone Number API from Alianza — 28 operation(s) for telephone number.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/partition/{partitionId}/telephonenumber` | — |
| POST | `/v2/partition/{partitionId}/telephonenumber` | Create telephone number |
| GET | `/v2/partition/{partitionId}/telephonenumber/{tn}` | Retrieve telephone number |
| DELETE | `/v2/partition/{partitionId}/telephonenumber/{tn}` | Delete telephone number |
| GET | `/v2/partition/{partitionId}/telephonenumber/search` | Telephone number search |
| GET | `/v2/partition/{partitionId}/telephonenumber/{tn}/availability` | Retrieve telephone number availability |
| POST | `/v2/partition/{partitionId}/telephonenumber/bulkimport` | Bulk telephone number import |
| POST | `/v2/partition/{partitionId}/telephonenumber/bulkimport_2` | Bulk telephone number import |
| GET | `/v2/partition/{partitionId}/telephonenumber/exportstatussearch` | Export as CSV telephone number status search |
| GET | `/v2/partition/{partitionId}/telephonenumber/exportstatussearch_2` | Export as CSV telephone number status search |
| PUT | `/v2/partition/{partitionId}/telephonenumber/{tn}/cooldown/recover` | Delete telephone number cooldown |
| PUT | `/v2/partition/{partitionId}/telephonenumber/{tn}/reserve` | Reserve a telephone number |
| DELETE | `/v2/partition/{partitionId}/telephonenumber/{tn}/reserve` | Delete a reserve on telephone number |
| GET | `/v2/partition/{partitionId}/telephonenumber/statussearch` | Telephone number status search |
| GET | `/v2/partition/{partitionId}/telephonenumber/{tn}/fmfmcheck` | — |
| GET | `/v2/partition/{partitionId}/telephonenumber/export` | — |
| GET | `/v2/partition/{partitionId}/telephonenumber/export_2` | Export telephone numbers as csv |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}` | Retrieve a telephone number on an account |
| PUT | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}` | Update telephone number on an account |
| DELETE | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}` | Delete telephone number on an account |
| PATCH | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}` | Update telephone number on an account |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber` | Retrieve all telephone numbers on an account |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber` | Create a telephone number or add telephone number to an account |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/groupid/{groupId}` | Retrieve all telephone number for end users |
| PUT | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/original/accept` | Accept original E911 address |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests` | Get all unfinished or archived activations with dynamic inventory |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests` | Activate a tn that will be requested dynamically from carrier. TN is not known at the moment of initiating of activation |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/{orderId}` | Get activation with dynamic inventory regardless of status |
| PUT | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/{orderId}` | Updates dynamic reservation object |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/actions/cancel` | Cancel and remove reservation object |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/actions/resubmit` | Revise and resubmit dynamic reservation object |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/tn-requests/{orderId}/refresh` | Refresh dynamic activation status |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/usages` | Retrieve a telephone number usages on an account |
| GET | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/correction` | Get adjusted E911 address |
| PUT | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/911-address/correction/accept` | Accept adjusted E911 address |
| POST | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/external` | Create or updates already activated telephone number to an account |
| PUT | `/v2/partition/{partitionId}/account/{accountId}/telephonenumber/{tn}/destination` | — |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/alianza/refs/heads/main/openapi/alianza-telephone-number-api-openapi.yml
- **Swagger** — https://raw.githubusercontent.com/api-evangelist/alianza/refs/heads/main/openapi/_original/alianza-apidocs-swagger2-original.json
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/alianza/refs/heads/main/mcp/alianza-tool-crosswalk.yml

## Other Alianza APIs (12)

- [Alianza Account API](https://apis.io/apis/alianza/alianza-account-api/)
- [Alianza Account Device API](https://apis.io/apis/alianza/alianza-account-device-api/)
- [Alianza Account Device Line API](https://apis.io/apis/alianza/alianza-account-device-line-api/)
- [Alianza Account Prevalidate API](https://apis.io/apis/alianza/alianza-account-prevalidate-api/)
- [Alianza Account User API](https://apis.io/apis/alianza/alianza-account-user-api/)
- [Alianza Address API](https://apis.io/apis/alianza/alianza-address-api/)
- [Alianza Asynchronous JOB Tracker API](https://apis.io/apis/alianza/alianza-asynchronous-job-tracker-api/)
- [Alianza Authorize API](https://apis.io/apis/alianza/alianza-authorize-api/)
- [Alianza Brand Settings API](https://apis.io/apis/alianza/alianza-brand-settings-api/)
- [Alianza Bulk Operation Collection API](https://apis.io/apis/alianza/alianza-bulk-operation-collection-api/)
- [Alianza Bulk Operation Job API](https://apis.io/apis/alianza/alianza-bulk-operation-job-api/)
- [Alianza Business Line API](https://apis.io/apis/alianza/alianza-business-line-api/)

## Tags

Telephone Number

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/alianza/alianza-telephone-number-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/alianza/.