Get Started with Phone Numbers

Introduction

Provision local and toll-free phone numbers instantly.

Phone Numbers

As a licensed carrier in the United States and Canada, along with our global tier one partners, Voxology gives you access to a massive inventory of available phone numbers. Instantly provision local (geographic) and toll-free phone numbers equipped with voice, messaging, emergency, and caller id name capabilities.

Voxology allows you to port your existing phone numbers as well as SMS-enable both local and toll-free phone numbers without switching your current voice provider.

Use Cases

• Business Phones // Provision numbers to power business phone systems.
• SMS/MMS // Send and receive text messages. Text-enable landlines.
• Emergency Calling // Support emergency calling from your PBX.
• DID Blocks // Provision large blocks of local phone numbers.
• Localized Calling // Provision local phone numbers for your nationwide storefronts.
• Vanity Numbers // Provision a vanity phone number to use for your IVR.
• Call Tracking // Track the effectiveness of marketing campaigns.
• Call Anonymization // Mask caller’s numbers for safety or to prevent platform leakage.
• Conferencing // Provision a phone number to host a conference line.

How It Works

Search our large inventory of available phone numbers, port your existing numbers, or text-enable existing landlines.

Available Phone Numbers

Overview

Voxology maintains a large inventory of available, toll-free and local phone numbers that are both voice and SMS enabled. After a phone number is released, it is adequately aged before it goes back into the available inventory.

Capabilities

Below is a list of capabilities available on Voxology phone numbers.

• Voice // Make and receive phone calls with your phone number.
• SMS // Send and receive text messages from your phone number. (NOTE: Toll-Free, 10DLC, or Short Code registration is required)
• MMS // Send and receive files (pictures, audio, and video) along with your messages (NOTE: Toll-Free, 10DLC, or Short Code registration is required).
• Emergency // Enable emergency services on a phone number, including E911.
• Caller ID Name // Set the CNAM on any local, US or Canadian phone number.

Search Options

Below is a list of supported query parameters for available phone numbers in both the Portal and API.

• Country
• Type // Local, Toll-Free
• Capabilities // Voice, SMS, MMS, Emergency, CNAM
• Region // City, State
• Prefix // Area Code
• Postal Code // Zip Code
• Rate Center
• LATA
• Vanity // Accepts numbers, letters, and two different kinds of wildcards

Special Phone Number Orders

If you are unable to find a phone number in a specific location (country, prefix, rate center, etc.), or you need to provision a large block of DIDs, please contact us - we’re happy to help.

Phone Number Porting

Voxology supports phone number porting in almost all US locations as well as many countries around the world. For one-off ports, you can download our Letter of Authorization in the Portal and follow the directions to initiate the port. For porting automation, please contact us to learn about the porting options in our API.

Caller ID Validation

Caller IDs or ANIs can be verified either in the Portal or the API to be used for outbound calling on our platform. Voxology supports a few different flavors of Caller ID verification depending on your use case. Contact us to learn more about the different ways to verify Caller IDs.

Hosted Numbers

Voxology supports hosted SMS. This allows you to text-enable local or toll-free landlines without having to change the voice provider. Businesses often want to use their existing phone number to support SMS/MMS, and their existing voice provider may not have the features they want. Hosted SMS allows you to do just that. If you are interested in automating this using our API, please contact us.

BYO RespORG

If you are already a RespOrg, or thinking about becoming one, Voxology allows you to bring your own credentials to our platform to allow you to provision toll-free phone numbers using your RespOrg.

BYO Carrier

Voxology’s SIP Interface enables you to bring your own carrier to Voxology’s Programmable Voice. By setting up a SIP Interface Domain in the Portal, you can point your non-Voxology phone numbers to the domain and then control the call using Voxology’s Programmable Voice just like you would a Voxology Phone Number.

Getting Started

Get started with Voxology’s Phone Numbers.

Provision Phone Number // Portal

Overview

This tutorial is a step-by-step guide to provisioning an available phone number in the Portal (Voxology’s User Interface).

Prerequisites

• Create an Account // Sign up for a Voxology Portal Account
• Make a Payment // After you sign up, Make a Payment in order to provision a phone number.

Tutorial

1. Search for an Available Phone Number

A. Go to the Buy Numbers page in the Portal.

B. Use the dropdown to the left of the search bar to select the country.

C. In the search bar, enter the prefix/area code, or the city and state (formatted as "City, State" e.g. Newport Beach, CA) you wish to search by and hit your 'Enter/Return' key to perform the search.

D. To access advanced search options, click the dropdown arrrow on the right side of the search bar.

E. In the advanced search panel, you can query by Type (Local or Toll-Free) and Capabilities (Voice, SMS, MMS, CNAM, and Emergency), as well as by: City/State, Rate Center, Prefix, Rate Center & Prefix, Postal Code, LATA, and Vanity.

2. Provision Your Selected Phone Number

A. From the list of numbers returned by your search, you may purchase an individual number by clicking the corresponding Buy button on the right. Or, you may purchase multiple numbers at once by clicking the corresponding checkboxes on the left, and then the Bulk Buy button on the right.

B. In the Purchase Inbound Number(s) Confirmation panel, you may modify capabilities on the number(s). Some capabilities may not be available or modifiable on all numbers. Next, in the same panel, select where you would like the number(s) to be assigned (Call Flows API, Parking Lot, or SIP Trunk), and then click the Confirm button.

C. Finally, use the toggle at the bottom of the panel to either assign the default End User Configuration to the number(s) or assign a new one.

D. Your newly purchased number(s) will be listed in your Manage Inbound Numbers page.

Now that you have provisioned your new phone number, any calls that are made to (or from) that number are routed through your application. Now it’s time to configure the phone number to work with Programmable Messaging, Programmable Voice, or SIP Trunking.

Provision Phone Number // API

Overview

This tutorial is a step-by-step guide to provisioning an available phone number in the API.

Prerequisites

• Create an Account // Sign up for a Voxology Portal Account
• Make a Payment // After you sign up, Make a Payment in order to provision a phone number.
• Get Your API key // Finally, go to your Applications and click Select to view your application’s details and get your unique API key

Tutorial

1. Search for an Available Phone Number

In order to provision a phone number via the API, you first need to search for an available phone number(s). To search for an available phone number, use the List Inbound Available Phone Numbers method.

Example Request // List Available Phone Numbers

curl -X GET \
  'https://api.voxolo.gy/v1/PhoneNumbers/Available?capabilities=voice,sms&search_by=prefixes&search_on=INSERT_YOUR_AREA_CODE' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY'

2. Provision Your Selected Phone Number

Once you have made your GET request, select a phone number(s) from the list of results and ‘copy’ it. To provision the number, use the Provision Phone Numbers method, ‘paste’ the number into the request body and assign it to either CallFlows (API), ParkingLot, or an inbound SIP Trunk Trunk/[id] in the path.

Example Request // Provision Phone Number

curl -X POST \
  https://api.voxolo.gy/v1/PhoneNumbers/CallFlows \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "phone_numbers": [
      {
        "no": "PASTE_YOUR_VOXOLOGY_NUMBER_HERE"
      }
    ]
}'

Now that you have provisioned your new phone number, any calls that are made to (or from) that number are routed through your application. Now it’s time to configure the phone number to work with Programmable Messaging, Programmable Voice, or SIP Trunking.