The following guide will show you how to:

  1. Search for and Buy Plivo Phone Numbers
  2. Submit Verification Documentation for Phone Numbers
  3. Check phone number invoice and payment logs


Search and Buy Plivo Phone Numbers

You can search for and buy Plivo phone numbers in two ways:

  1. Through the Number Search tab in your Plivo GUI (graphical user interface) or
  2. By using Plivo's Phone Number API (application programming interface).

Through the Plivo GUI

  1. Login and Navigate to the Number Search tab in your Plivo GUI.
  2. Search by phone number digits, location (e.g., California), LATA (Local Access Transport Area), or rate center.
  3. Filter phone numbers by features (i.e., voice, SMS, or both) and number type (i.e., fixed, mobile, toll-free, or any).
  4. Click on Buy to purchase your new Plivo phone number.
  5. All of your phone numbers can be found on the in the Numbers tab.

Screenshot - New Searchable Phone Number Inventory

By using Plivo's Phone Number API

  1. To search, make a HTTP GET request to the Phone Number API. This API lets you search for fixed, mobile and tollfree numbers available on Plivo. Searches can be performed based on the country ISO, pattern, number type and region. We return a list of numbers which can then be bought. Go to the Phone Number API doc for full details on each parameter.
  2. GET https://api.plivo.com/v1/Account/{auth_id}/PhoneNumber/
  3. To buy, make a HTTP POST request to the Phone Number API. Go to the Phone Number API doc for full details.
  4. POST https://api.plivo.com/v1/Account/{auth_id}/PhoneNumber/{number}/
  5. You can list all of your numbers by making a HTTP GET request to the Numbers API.
  6. GET https://api.plivo.com/v1/Account/{auth_id}/Number/


Verification Documentation UI

You may be prompted to upload verification documentations for your phone number. You may do this directly in your Plivo Dashboard in your accounts page.

Screenshot - New Searchable Phone Number Inventory

Phone Number Payment Log

Once you purchase a Plivo number, your account will be charged for the price of the number. You can check the invoice through the Payments tab of your Plivo GUI.

Screenshot - Plivo Buy Numbers Payment Log