Description

Search for numbers available to purchase.

Parameters

string RangeThe 3-6 digit area code (STD). For example; '020', '0800', '01234'.
string ValueA string of digits which should appear within the number.
string BandA two digit string identifying the memorability level for the number.

  • '00' > Standard

  • '10' > Bronze

  • '20' > Silver

  • '30' > Gold

  • '40' > Platinum

  • '50' > Diamond



For pricing, please refer to your pricing agreement or contact [email protected].
OffsetWill cause the function to return a number set starting from the Offset index.
LimitWill cause the function to return a maximum amount of number equal to Limit.

Request

<?xml version="1.0"?>
<NoveroRequest>
    <Request target="NoveroNumberSearch" name="Search" id="Request1">
        <Range>0800</Range>
        <Value>468</Value>
        <Band>00</Band>
        <Offset>10</Offset>
        <Limit>6</Limit>
    </Request>
</NoveroRequest>
<?php
    require_once('TTNCApi.php');
    $Api = new TTNCApi('<username>', '<password>', '<VKey>');
    $Request = $Api->NewRequest('NoveroNumberSearch', 'Search', 'Request1');
    $Request->SetData('Range', '0800');
    $Request->SetData('Value', '468');
    $Request->SetData('Band', '00');
    $Request->SetData('Offset', '10');
    $Request->SetData('Limit', '6');
    $Api->MakeRequests();
    $Response = $Api->GetResponseFromId('Request1');
?>
require TTNCApi
api = TTNCApi.new('<username>', '<password>', '<vkey>')
request = api.newrequest('NoveroNumberSearch', 'Search', 'Request1')
request.setdata('Range', '0800')
request.setdata('Value', '468')
request.setdata('Band', '00')
request.setdata('Offset', '10')
request.setdata('Limit', '6')
api.makerequest()
p request.getresponse()
api = TTNCApi('<username>', '<password>', '<vkey>')
request = api.newrequest('NoveroNumberSearch', 'Search', 'Request1')
request.setdata('Range', '0800')
request.setdata('Value', '468')
request.setdata('Band', '00')
request.setdata('Offset', '10')
request.setdata('Limit', '6')
api.makerequest()
p request.getresponse()
using System;
using TTNCApi;
 
class Program
{
    static void Main(string[] args)
    {
        TTNCApi api = new TTNCApi("<username>", "<password>", "<vkey>");
        TTNCRequest request = api.NewRequest("NoveroNumberSearch", "Search", "Request1");
        request.setData("Range", "0800");
        request.setData("Value", "468");
        request.setData("Band", "00");
        request.setData("Offset", "10");
        request.setData("Limit", "6");
        api.MakeRequests();
        TTNCParser dic = request.GetResponse();
     }
}

Response

<?xml version="1.0"?>
<NoveroResponse>
    <Response target="NoveroNumberSearch" name="Search" Code="200" RequestId="Request1">
        <Numbers>
            <Number>
            <RawNumber>08001182523</RawNumber>
            <alpha></alpha>
            <band>00</band>
            <code>free</code>
            <range>0800</range>
            <tariff>Freephone</tariff>
            <number>0800 118 2523</number>
            </Number>
 
            ...
 
        </Numbers>
        <BandCounts>
            <BandCount Band="00">8,867</BandCount>
            <BandCount Band="10">2,866</BandCount>
            <BandCount Band="20">227</BandCount>
            <BandCount Band="30">167</BandCount>
            <BandCount Band="40">154</BandCount>
            <BandCount Band="50">10</BandCount>
        </BandCounts>
        <BandPrice>&pound;10</BandPrice>
        <BandRewnewalPrice>&pound;10</BandRewnewalPrice>
        <BandRewnewalFreq>yearly</BandRewnewalFreq>
    </Response>
<NoveroResponse>