There are two ways you can search and buy numbers:

  1. By using Plivo’s Number Search API or

  2. Through the Buy Numbers tab in your Plivo User Interface


Both methods of Plivo’s phone number search gives you the ability to not only search by phone number digits, but also by location (e.g., California). You can also filter phone numbers by features (i.e., voice, SMS, or both) and number type (i.e., fixed, mobile, toll-free, or any). For US phone numbers, you can also filter by LATA (Local Access Transport Area), and rate centre. See the complete details of each search parameter on our PhoneNumber API documentation.


Please note that in order to buy numbers, you need to have enough credits in your account depending on the monthly rental charges.


Through the Plivo User Interface

1. Login and Navigate to the Number Search tab in your Plivo User Interface.

2. Search by phone number digits, location (e.g., California), LATA (Local Access Transport Area), or rate centre.

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


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 toll free numbers available within Plivo’s phone number inventory. Searches can be performed based on the country ISO, pattern, number type and region. Plivo will then return a list of phone numbers which can then be purchased. Go to the Phone Number API doc for full details on each parameter.    

    GET https://api.plivo.com/v1/Account/{auth_id}/PhoneNumber/


  1. To purchase a phone number, make a HTTP POST request to the Phone Number API. Go to the Phone Number API doc for full details.

    POST https://api.plivo.com/v1/Account/{auth_id}/PhoneNumber/{number}/