Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Blocked numbers

A blocked number is a phone number or number prefix that your PBX refuses to handle. You can block exact numbers to stop one specific caller, or block prefixes to stop an entire country or area code. Each block applies to incoming, outgoing, or both directions.

Overview

Blocking numbers is your first defense against spam, robocallers, premium-rate abuse, and unwanted outbound destinations. The telephony platform enforces these rules at call time, so a blocked call is rejected before it reaches your users.

What it does

Each rule matches a number in one of two ways, in one or both directions:

Mode What it matches
Exact number Only the specific number, full E.164 including country code.
Prefix Every number starting with the digits you enter.

Prefix matching is the workhorse - blocking +90 stops every call from Turkey in one rule, more durable than listing individual numbers. Direction is set by Apply to: incoming (anti-spam), outgoing (cost control), or both.

Goal Configuration
Block a specific spam caller Exact number, Incoming.
Block an entire country's inbound calls Prefix on the country code, Incoming.
Block premium-rate dialling Prefix on the premium-rate range, Outgoing.

See also

Form fields

Fields available in the create and edit forms.

General

Phone number or prefix

The phone number or prefix to block. Enter a full E.164 number for exact matching, or leading digits for prefix matching.

Match type

How the number is matched against calls.

  • false Exact number Blocks only the specific number you entered.
  • true Prefix Blocks all numbers that start with the digits you entered.
Apply to

Which call direction the block covers: incoming calls only, outgoing calls only, or both directions.

  • incoming_call Incoming call Calls from the blocked number or prefix never reach your PBX users.
  • outgoing_call Outgoing call Users on the PBX cannot dial the blocked number.
  • both_directions Both directions Both directions are blocked.

Updated