This guide will serve as instructions for how you can purchase and provision your very first phone number or a new group of numbers in the Ytel API user interface. For instructions on how to do this programatically, please see further below

There are several ways to purchase a number on your account, Ytel provides both a Web interface and API's to you for this purpose. 

First we will cover the Web Interface portion.
Steps are as follows, 

  1. Login @ app.ytel.com
  2.  Navigate to the 'Numbers' tab
  3. Select 'Buy Numbers' from the dropdown
  4. Filter/Search for your desired Area-code/State
  5. Click 'Buy' for the desired number ( you can also multi select and purchase more than one at a time)

When you receive a 'Success' message - congratulations! You have purchased your first API number.

Next, we will cover Purchasing via a couple different API's. 

First is the 'Buy Number API' (Full doc's @ https://docs.ytel.com/reference#incomingphonebuynumber )

To fully utilize the 'Buy Number' API in a programatic fashion you will first need to run and digest the output of another of our API's. That API is 'View Available Number' Full documentation @
https://docs.ytel.com/reference#incomingphoneavailablenumber 

When you run a View Available number API it will return a list of numbers along with some other additional information, You will want to parse 'Phonenumber: {phonenumber}' from the response and feed into your 'Buy Number' API request. 


Additionally there is another way to buy numbers. That way is by using our 'Bulk Buy Number' API. ( full documentation found @
https://docs.ytel.com/reference#incomingphonebulkbuy

Simply, you specify the area code and quantity of numbers while specifying "leftover=true" if you intend to buy 'as much as possible' up to your specified quantity. If 'Leftover=false' then we will error the request if the available numbers do not match the requested amount.

 

Did this answer your question?