ALalianza
Telephone Number

Retrieve telephone numbers in the partition inventory

Use to retrieve information for up to 500 telephone numbers, which are in the partition's telephone number inventory. This does NOT include inventory from subpartitions.<br/><br/> If you want to get more than 500 telephone numbers, you can use the <a href="#/~operation/Telephone%20Number/asyncExportTnInventory">asyncExportTnInventory</a> endpoint.

get/v2/partition/{partitionId}/telephonenumber

Request

Path parameters

partitionIdstring required

ID of partition, refers to <a href="#/~schema/PartitionX">Partition.id</a>

Response

Successful operation

partitionIdstring
phoneNumberstring
rateCenterstring
rateCenterReorderNamestring
statestring
countrystring
prefixstring
accountIdstring
carrierIdstring

The <a href="#/~schema/InboundCarrierX">inboundCarrierX.id</a> that services the telephone number.

cooldownExpireDatestring date-time
cooldownRecoveredDatestring date-time
functionType'ELS' | 'TollFree' | 'TemporaryNumber' | 'SPTN'
claimTicketIdstring
matchesZipboolean

When this object is returned as part of a <a href="#/~operation/Telephone%20Number/tnSearch">search</a> that uses a zip code, results for nearby zip codes are also returned. This field indicates if the returned data matches the queried zip code.

distancenumber float

When this object is returned as part of a <a href="#/~operation/Telephone%20Number/tnSearch">search</a> that uses a zip code, results for nearby zip codes are also returned. This field represents the distance (in miles) from the specified zip code.

byotnboolean

Bring Your Own Telephone Number (byotn) is a feature that allows the service provider to manage the rate center footprint coverage for a number.

activationDateinteger
isInInventoryboolean
operationalStatus'ACTIVE' | 'STAGED'
idstring
portboolean
tagsstring[]

Optional tags for categorizing the telephone number (e.g., location, service type). Tags are stored as attributes in the Attribute Service. Format is lowercase with hyphens replacing spaces. Maximum 10 tags per number.

Changes

No recorded changes to this operation across all 1 revision of this API.