Sidebar Menu

GetAvailableIncomingNumbers

This method will list a random 10 lines available for incoming calls. You can assign these lines via the AssignIncomingNumber method to your license key. You can leave the area code field blank to get any available toll-free lines (888 and 877 numbers are currently the most common).

Syntax

GetAvailableIncomingNumbers(AreaCodeFilter)

Request Parameters

Parameter Name Description Data Type Required Sample Value
AreaCodeFilter

String True

Response

Returns: Array of String values

Description: A list of incoming numbers.

Code Samples

/* https://ws.cdyne.com/notifyws/phonenotify.asmx?wsdl was added as a Web Reference and given the name WSDL */

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Incoming_Numbers.WSDL;

namespace Incoming_Numbers
{
    class Program
    {
        static void Main(string[] args)
        {
            WSDL.PhoneNotify PN = new WSDL.PhoneNotify();

            Array Incoming = PN.GetAvailableIncomingNumbers("888");

            if (Incoming.Length > 0)
            {
                Console.WriteLine("Available Incoming Numbers:" + "\n");

                foreach (string Number in Incoming)
                {
                    Console.WriteLine(Number);
                }
            }
            else Console.WriteLine("No incoming numbers available.");

            Console.ReadLine();
        }
    }
}
' https://ws.cdyne.com/notifyws/phonenotify.asmx?wsdl was added as a Web Reference and given the name WSDL

Imports GetAvailableIncomingNumbers.WSDL
Module Module1

    Sub Main()

        Dim PN As New WSDL.PhoneNotify
        Dim Incoming As Array

        Incoming = PN.GetAvailableIncomingNumbers("888")

        If (Incoming.Length > 0) Then

            Console.WriteLine("Available Incoming Numbers:" & vbLf)

            For Each Number In Incoming

                Console.WriteLine(Number)

            Next

        Else : Console.WriteLine("No incoming numbers available.")

        End If

        Console.ReadLine()

    End Sub

End Module
Dim request, oXMLHttp, url
url = "http://ws.cdyne.com/NotifyWS/PhoneNotify.asmx"

request = "<?xml version='1.0' encoding='utf-8'?>" & _
"<soap:Envelope xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"" xmlns:xsd=""http://www.w3.org/2001/XMLSchema"" xmlns:soap=""http://schemas.xmlsoap.org/soap/envelope/"">" & _
"<soap:Body>" & _
"<GetAvailableIncomingNumbers xmlns=""http://ws.cdyne.com/NotifyWS/"">" & _
"<AreaCodeFilter>757</AreaCodeFilter>" & _
"</GetAvailableIncomingNumbers>" & _
"</soap:Body>" & _
"</soap:Envelope>"

Set oXMLHttp = CreateObject("MSXML2.ServerXMLHTTP")
oXMLHttp.open "POST", url, False
oXMLHttp.setRequestHeader "Content-Type", "text/xml; charset=utf-8"
oXMLHttp.send request
response = oXMLHttp.responseText

MsgBox oXMLHTTP.responseText
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;

public final class GetAvailableIncomingNumbers {
    public static void main(String[] args) {
        try {
            URL url = new URL("http://ws.cdyne.com/NotifyWS/PhoneNotify.asmx/GetAvailableIncomingNumbers?"
                            + "AreaCodeFilter=888");
            try {
                InputStream in = url.openStream();
                StreamSource source = new StreamSource(in);
                printResult(source);
            } catch (java.io.IOException e) {
                e.printStackTrace();
            }
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }
    }

    private static void printResult(Source source) {
        try {
            ByteArrayOutputStream bos = new ByteArrayOutputStream();
            StreamResult sr = new StreamResult(bos);
            Transformer trans = TransformerFactory.newInstance().newTransformer();
            Properties oprops = new Properties();
            oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
            trans.setOutputProperties(oprops);
            trans.transform(source, sr);
            System.out.println("**** Response ******");
            System.out.println(bos.toString());

            bos.close();
            System.out.println();
        } catch (Exception e) {
        }
    }
}
GET /NotifyWS/PhoneNotify.asmx/GetAvailableIncomingNumbers?AreaCodeFilter=string HTTP/1.1
Host: ws.cdyne.com
POST /NotifyWS/PhoneNotify.asmx/GetAvailableIncomingNumbers HTTP/1.1
Host: ws.cdyne.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

AreaCodeFilter=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<ArrayOfString xmlns="http://ws.cdyne.com/NotifyWS/">
  <string>string</string>
  <string>string</string>
</ArrayOfString>
POST /NotifyWS/PhoneNotify.asmx HTTP/1.1
Host: ws.cdyne.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://ws.cdyne.com/NotifyWS/GetAvailableIncomingNumbers"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetAvailableIncomingNumbers xmlns="http://ws.cdyne.com/NotifyWS/">
      <AreaCodeFilter>string</AreaCodeFilter>
    </GetAvailableIncomingNumbers>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetAvailableIncomingNumbersResponse xmlns="http://ws.cdyne.com/NotifyWS/">
      <GetAvailableIncomingNumbersResult>
        <string>string</string>
        <string>string</string>
      </GetAvailableIncomingNumbersResult>
    </GetAvailableIncomingNumbersResponse>
  </soap:Body>
</soap:Envelope>
POST /NotifyWS/PhoneNotify.asmx HTTP/1.1
Host: ws.cdyne.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetAvailableIncomingNumbers xmlns="http://ws.cdyne.com/NotifyWS/">
      <AreaCodeFilter>string</AreaCodeFilter>
    </GetAvailableIncomingNumbers>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetAvailableIncomingNumbersResponse xmlns="http://ws.cdyne.com/NotifyWS/">
      <GetAvailableIncomingNumbersResult>
        <string>string</string>
        <string>string</string>
      </GetAvailableIncomingNumbersResult>
    </GetAvailableIncomingNumbersResponse>
  </soap12:Body>
</soap12:Envelope>