CallFire Solutions

Search Available Numbers

Follow

SEARCH AVAILABLE NUMBERS

Search for new numbers that are available for purchase

This operation allows finding numbers available for purchase. It allows looking for regular numbers or toll free ones. Other search parameters include: phone prefix, city, and zip code. The maximum number (count) of numbers to be returned must also be specified.

REQUEST PARAMETERS

ParameterDemo ValueDescriptionData Type
SearchAvailableNumbers     object
Region   Region of number represented by city, state, prefix, etc... object
Prefix 4-7 digit prefix string
City Name of a city string
State State abbreviation string
Zipcode 5 digit zipcode string
Country 2 digit country code string
Lata Lata string
RateCenter   string
Latitude Latitude float
Longitude Longitude float
TimeZone   string
TollFree   boolean
Count Keywords request by query int

RESPONSE PARAMETERS

ParameterDescriptionData Type
NumberQueryResult List of Numbers returned from query  
TotalResults Results count long
Number Info about Number like Region  
Number 11 digit E.164 number PhoneNumber
NationalFormat Phone number formatted for local string
TollFree Is toll free number boolean
Region Region of number represented by city, state, prefix, etc...  
Prefix 4-7 digit prefix string
City Name of a city string
State State abbreviation string
Zipcode 5 digit zipcode string
Country 2 digit country code string
Lata Lata string
RateCenter   string
Latitude Latitude float
Longitude Longitude float
TimeZone   string
Status [PENDING, ACTIVE, RELEASED, UNAVAILABLE] NumberStatus
LeaseInfo Info about Lease  
LeaseBegin Date lease began date
LeaseEnd Date lease ends date
AutoRenew Is lease set to renew each month boolean
NumberConfiguration Configure Call and Text features  
CallFeature [UNSUPPORTED, PENDING, DISABLED, ENABLED] NumberFeature
TextFeature [UNSUPPORTED, PENDING, DISABLED, ENABLED] NumberFeature
InboundCallConfigurationType [TRACKING, IVR] InboundType
InboundCallConfiguration    
CallTrackingConfig    
Id Unique ID of InboundConfig long
TransferNumber   List[PhoneNumber]
Screen   boolean
Record   boolean
IntroSoundId   long
WhisperSoundId   long
IvrInboundConfig    
Id Unique ID of InboundConfig long
DialplanXml   string

EXAMPLE


using RestSharp;

namespace [your-namespace]
{
    public class [your-class]
    {
        public string SearchAvailableNumbers()
        {
            var client = new RestClient("https://www.callfire.com/api/1.1/rest/");
            client.Authenticator = new HttpBasicAuthenticator("YourLoginId", "password");

            var request = new RestRequest("number/keyword", Method.GET);
            request.AddParameter("Prefix", "1201");
            request.AddParameter("City", "Seattle");
            request.AddParameter("TollFree", "true");
            request.AddParameter("Count", "1");

            var response = client.Execute(request);
            string content = response.Content;
            return content;
        }
    }
}

The XML returned is:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<r:ResourceList xmlns="http://api.callfire.com/data" xmlns:r="http://api.callfire.com/resource" totalResults="1">

   <Number>

       <Number>18559897846</Number>

       <NationalFormat>18559897846</NationalFormat>

       <TollFree>true</TollFree>

   </Number>

</r:ResourceList>

Have more questions? Submit a request

Comments