My Numbers reference#

My Numbers reference explains the fields, statuses, values, indicators, and service states shown in the My Numbers section and on DID number details pages.


Main fields#

Field

Access

Description

DID number

Read-only

The telephone number assigned to the account. Selecting the DID number from the My Numbers table opens the DID number details page.

Country / City

Read-only

The country and city associated with the DID number. Local numbers show the city. Non-local numbers may show the number type instead.

Number type

Read-only

The classification of the DID number based on numbering type and routing category

Status

Read-only

The current lifecycle or operational condition of the DID number. Read together with routing, capacity, verification, and renewal fields.

Time left

Read-only

The remaining time in the current service period. Status indicators associated with the DID number can show whether the remaining service time requires attention.

Supported features

Read-only

Icons that show which capabilities the DID number can support. A supported feature does not mean the feature is configured or active.

Description

Editable

A custom description used to identify the DID number. Can be updated for one number or by batch action.

Number type values#

Value

Description

Local

A geographic DID number associated with a city or local area.

Mobile

A DID number associated with mobile numbering.

National

A DID number associated with national numbering.

Shared Cost

A DID number type where call costs may be shared according to local numbering rules.

Toll-free

A DID number type that allows callers to reach the number without standard caller-paid charges where supported.

Global / UIFN

A global or Universal International Freephone Number type.

Status values#

Status

Description

green-status Active

The DID number has remaining service time and can receive services when required routing and capacity configuration are complete.

yellow-status Not Configured

Required voice routing or usable inbound capacity is missing. DID numbers in this state cannot receive inbound calls.

yellow-status Awaiting Registration

End-user verification is required before activation can be completed.

yellow-status Expiring Soon

The DID number will not renew automatically because no billing cycles remain.

yellow-status Porting in progress

The DID number has been added to the account and is still in the porting process.

red-status Blocked

The DID number is blocked and cannot receive incoming calls.

red-status Terminated

The DID number has no service time left or was canceled.

Supported features#

Feature

Description

inbound-calls Inbound calls

The DID number supports inbound call delivery through supported inbound voice trunk types.

local-cli Local CLI

The DID number can be used as caller ID with DIDWW local routes.

fax Inbound Fax

The DID number supports inbound fax using T.38 or G.711u passthrough.

sms-in Inbound SMS

The DID number supports inbound SMS delivery through supported inbound SMS trunk types.

sms-out Outbound P2P SMS

The DID number supports outbound person-to-person SMS through SMPP and HTTP.


Trunks#

Field

Access

Description

Inbound voice trunk

Editable

The inbound voice trunk assigned to the DID number. The assigned trunk determines how inbound calls are routed from DIDWW to the configured destination. See Assign a voice trunk.

Inbound SMS trunk

Editable

The inbound SMS trunk assigned to the DID number. SMS routing requires an SMS-capable DID number. See Assign an SMS trunk.

Inbound voice trunk values#

Value

Description

Voice: none

No inbound voice trunk is assigned.

SIP trunk

A SIP trunk assigned for inbound call delivery. See Creating a New SIP Trunk.

PSTN trunk

A PSTN trunk assigned for inbound call delivery. See PSTN Trunk.

phone.systems™ trunk

A phone.systems™ trunk assigned for inbound call delivery.

Trunk group

A trunk group assigned for inbound call delivery. See Trunk Groups.

Inbound SMS trunk values#

Value

Description

SMS: none

No inbound SMS trunk is assigned.

SMS to Email trunk

An SMS trunk that delivers incoming messages to email. See SMS to Email Trunk.

HTTP IN trunk

An SMS trunk that delivers incoming messages to an HTTP endpoint. See HTTP IN Trunk.

SMPP ESME trunk

An SMS trunk that delivers incoming messages to an ESME connection. See SMPP ESME.

SMPP SMSC trunk

An SMS trunk that delivers incoming messages to an SMSC connection. See SMPP SMSC.

SMS trunk group

An SMS trunk group assigned for inbound SMS delivery. See SMS Trunk Groups.


End user details#

Field

Access

Description

Identity

Configurable

The identity record assigned to the DID number for registration or regulated services. Displays None when no identity is assigned. See Identities.

Address

Configurable

The address record assigned to the DID number for registration or regulated services. Displays None when no address is assigned. See Addresses.

Address Verification

Read-only

The Address Verification reference associated with an End-user verification request. See Verifications.

Regulatory area

Read-only

The regulatory area used to determine registration or service requirements. Requirements can vary by country, region, number type, and service.

Address verification states#

State

Description

green-verification Active

End-user details have been verified and approved.

yellow-verification Pending

End-user details are under review.

red-verification Rejected / Not assigned

The DID number requires verified End-user details to activate. Assign or update the End-user information and resubmit it for verification. See Assign end-user details.


Capacity#

Field

Access

Description

Capacity limit

Editable

The maximum number of concurrent inbound calls allowed for the DID number. Displays Not configured when no specific capacity limit is set, or a number when a limit is configured. Updating this value limits calls for the DID number and does not increase total account capacity. See Set capacity limits.

Channels included

Editable when available

The included channel mode for the DID number. Values are 2 included for DID+2 mode and 0 included for DID+0 mode. See Capacity.

Dedicated channels

Editable

Flat-rate channels assigned directly to the DID number. Displays None when no additional dedicated channels are assigned, or a number when channels are assigned. See Flat-rate channels.

Capacity group

Editable

The shared or metered Capacity group assigned to the DID number. Displays None when no Capacity group is assigned, or the Capacity group name when assigned. See Capacity groups.


Order details#

Field

Access

Description

Order ref.

Read-only

The order reference number associated with the DID number.

Assigned on (UTC)

Read-only

The date and time when the DID number was assigned to the account.


Billing#

Field

Access

Description

Renew price

Read-only

The price charged to renew the DID number for the selected billing period.

Expiry date (UTC)

Read-only

The date and time when the current DID number service period ends.

Billing period

Read-only

The renewal interval for the DID number.

Billing cycles left

Editable

The number of remaining billing cycles before automatic renewal stops.

Billing period values#

Value

Description

Recurring monthly

The DID number renews for 1 month at a time.

Recurring quarterly

The DID number renews for 3 months at a time.

Recurring semi-annually

The DID number renews for 6 months at a time.

Recurring annually

The DID number renews for 12 months at a time.

Recurring bi-annually

The DID number renews for 24 months at a time.

Billing cycles left values#

Value

Description

Empty

The DID number renews indefinitely until you remove the DID number or change the billing cycles left value.

More than 0

The DID number renews automatically until the remaining billing cycles reach 0.

0

Automatic renewal is disabled. The DID number moves toward expiration when the current service period ends.


Services#

Service

Description

emergency-service Emergency Calling

Emergency Calling service for the DID number. See Emergency Calling.

a2p-service A2P Campaign

A2P campaign service for outbound A2P SMS. See A2P Campaigns.

cnam-service CNAM OUT

Outbound caller name service for the DID number. See Manage CNAM OUT.

Emergency Calling statuses#

Status

Available action

Description

emergency-gray Not activated

Contact sales

Emergency Calling is not enabled for the account or DID number.

emergency-gray Not configured

Configure

Emergency Calling is available, but no emergency calling configuration is assigned to the DID number.

emergency-yellow New

View

Emergency Calling configuration has been created and is waiting for review.

emergency-yellow In process

View

Emergency Calling configuration is under review.

emergency-service Active

View

Emergency Calling is configured and active for the DID number.

emergency-red Changes required

View

Emergency Calling configuration requires corrections before it can be approved.

emergency-red Cancellation pending

View

Emergency Calling cancellation has been requested and is pending closure.

CNAM OUT statuses#

Status

Available action

Description

cnam-gray Not configured

Configure

CNAM OUT is not configured for the DID number.

cnam-yellow Pending

CNAM OUT configuration has been submitted and is pending review.

cnam-service Active

Remove or Edit

CNAM OUT is configured and active for the DID number.

cnam-red Cancellation pending

A CNAM OUT removal request has been submitted and is pending closure.

A2P Campaign statuses#

Status

Available action

Description

a2p-gray Not configured

Configure

No A2P Campaign is configured for the DID number.

a2p-yellow New

View

A2P Campaign assignment has been created and is waiting for review.

a2p-yellow Pending

View

A2P Campaign assignment is under review.

a2p-service Active

View

A2P Campaign is configured and active for the DID number.

a2p-red Changes required

View

A2P Campaign assignment requires corrections before it can be approved.

a2p-red Cancellation pending

View

A2P Campaign cancellation has been requested and is pending closure.