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 @

  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 @ )

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 @ 

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 @

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.

For customer support, email us at or start a live chat, we are available M-F 6am-6pm PST


Did this answer your question?