0151 355 4555



Finds the first number from the list supplied that is callable, i.e. is not registered on the CTPS. This is useful if you have more than one number for a person and want to check which number you can contact them on.

If there is a callable number in the list you provide, the resulting CTPSOutput structure will contain the first such callable number in the TelephoneNumber field, and the Callable field will be set to true. Otherwise, the TelephoneNumber field will be blank and the Callable field will be false.

Each telephone number that needs to be searched against the CTPS results in an extra charge on your account for the appropriate number of credits for a CTPS search. If you supply two telephone numbers and the first one is callable, you will only be charged for one CTPS lookup as we never have to look up the second one. However, if the first number is not callable you will be charged for two CTPS searches as we have to search for both numbers against the CTPS.

View all CTPS (part of the data validation suite) methods

Code Samples

<!-- Import the Integr8 Ajax API -->
<!-- NOTE: Get your own API key to use in the following script tag from: -->
<!-- http://www.data-8.co.uk/integr8/Admin/Ajax.aspx -->
<script src="https://webservices.data-8.co.uk/Javascript/Loader.ashx?key=your-api-key" type="text/javascript">

<script type="text/javascript">

function loadIntegr8() {
  // Load the CTPS Integr8 service

function GetCallableNumber(numbers) {
  /// <param name="numbers">string[]</param>
  var ctps = new data8.ctps();

function showGetCallableNumberResult(result) {
  // Check that the call succeeded, and show the error message if there was a problem.
  if (!result.Status.Success) {
    alert('Error: ' + result.Status.ErrorMessage);
  else {
    // TODO: Process method results here.
    // Results can be extracted from the following fields:
    // result.Callable
    //   Indicates if the supplied telephone number is callable (i.e. not on the CTPS)
    // result.TelephoneNumber
    //   Contains the original telephone number if it is callable.