Number List settings reference

This reference describes the filters, fields, values, and actions available for Number Lists and Number List items under Voice > Inbound Trunks > Number Lists. For configuration steps, see Configure number lists.

Number Lists

A Number List defines how inbound calling numbers are matched and what happens when no Number List item matches a call.

Filters

Use the controls above the Number Lists table to narrow the displayed lists. Filters can be combined.

Filter	Filter condition	Description
Friendly Name	Text filter	Shows Number Lists whose friendly name matches the entered text.
Mode	Single-select filter	Shows Number Lists with the selected value. Any does not restrict the results by mode.
Default Action	Single-select filter	Shows Number Lists with the selected value. Any does not restrict the results by default action.

Main fields

Field	Access	Description
Friendly Name	Editable	Name used to identify the Number List in the DIDWW User Panel. Select the name to open the list’s Number List items.
Mode	Editable	Determines whether an item must match the complete calling number or the beginning of the calling number.
Default Action	Editable	Action applied when no Number List item matches the calling number.
Actions	Contextual	Opens the actions available for the Number List.

Settings

Field	Availability	Description
Friendly name	Required	Name used to identify the Number List in the DIDWW User Panel. Accepted length is up to 160 characters.
Mode	Required	Matching method applied to the Number List items. The default value is Full number match.
Default action	Required	Action applied when no Number List item matches the calling number. The default value is Allow call.

Mode values

Value	Example	Description
Full number match	Add 12025550123 to match that complete calling number.	A Number List item matches only when its complete number is identical to the inbound calling number. The item does not match 120255501234.
Prefix match	Add 1202 to match calling numbers that begin with those digits.	A Number List item matches when its configured digits appear at the beginning of the inbound calling number and the number satisfies the item’s length limits. For example, the prefix can match 12025550123.

Default Action values

Value	Description
Allow call	Allows the call when no Number List item matches the calling number.
Reject call	Rejects the call when no Number List item matches the calling number.

Actions

Action	Availability	Description
Edit	All Number Lists	Opens the Number List settings for editing.
Manage numbers	All Number Lists	Opens the Number List items currently stored in the list.
Add numbers	All Number Lists	Opens the dialog for adding one or more Number List items without first opening the items table.
Delete	Unassigned Number Lists	Deletes the Number List after confirmation. A Number List assigned to a trunk cannot be deleted. The confirmation dialog does not check the assignment, so the list remains in the table after you confirm.

Important

To delete an assigned Number List, first use the CLI Number List filter under Voice > Inbound Trunks > Trunks to find the trunks that use it. Remove the Number List from those trunks, and then delete the list.

Number List items

Number List items contain the numbers or prefixes evaluated by a Number List. When an item matches, its Action overrides the Number List’s Default Action. When no item matches, the Default Action applies.

Filters

Use the controls above the Manage Numbers table to narrow the displayed items. Filters can be combined.

Filter	Filter condition	Description
Number	Text filter	Shows items whose number or prefix matches the entered text.
Action	Single-select filter	Shows items with the selected value. Any does not restrict the results by action.

Main fields

Field	Access	Description
Number	Editable	Complete number or prefix evaluated according to the Number List’s Mode. Accepted length is up to 100 characters.
Min. Length	Editable	Minimum total length of a calling number that can match a prefix item. Accepted values range from 0 to 100.
Max. Length	Editable	Maximum total length of a calling number that can match a prefix item. Accepted values range from 0 to 100.
Action	Editable	Action applied when the item matches the calling number.
Actions	Contextual	Provides controls for editing or deleting the item.

Add Numbers fields

Field	Availability	Description
Numbers or prefixes to be added	Required	One or more numbers or prefixes to add. Separate multiple values with commas or new lines, for example 15551234567, 1234567890. Each number or prefix accepts up to 100 characters. Add up to 500 numbers or prefixes per request. Submit additional batches to add more.
Action	Required	Action applied when an added item matches the calling number. The default value is Allow call.
Min. Length	Optional for Prefix match	Minimum total length of a calling number that can match the prefix. The accepted range is 0 to 100. The default value is 0.
Max. Length	Optional for Prefix match	Maximum total length of a calling number that can match the prefix. The accepted range is 0 to 100. The default value is 100.

The Edit Number dialog provides the same settings for one existing Number List item. Its Number field contains a single complete number or prefix.

Action values

Value	Description
Allow call	Allows the call when the Number List item matches the calling number.
Reject call	Rejects the call when the Number List item matches the calling number.

Actions

Action	Availability	Description
Add Numbers	All Number Lists	Opens the dialog for adding one or more items to the Number List.
Edit	Existing items	Opens the selected Number List item for editing.
Delete	Existing items	Deletes the selected Number List item after confirmation.
Delete Number(s)	Selected items	Deletes the items selected in the Manage Numbers table through the Batch Actions menu.

Related resources

• Configure number lists — Create a Number List, add items, and assign the list to a SIP or PSTN trunk.

• Number List use cases — Review example allow and reject configurations.

• SIP trunk settings reference — Review the SIP trunk fields that affect Number List matching and assignment.

• PSTN trunk settings reference — Review the PSTN trunk fields that affect Number List matching and assignment.

• Number List rejection troubleshooting — Identify calls rejected by a Number List in inbound Call Logs.