0151 355 4555



Finds the first number from the list supplied that is callable, i.e. is not registered on the TPS. 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 TPSOutput 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 TPS results in an extra charge on your account for the appropriate number of credits for a TPS search. If you supply two telephone numbers and the first one is callable, you will only be charged for one TPS 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 TPS searches as we have to search for both numbers against the TPS.

View all Telephone Preference Service (part of the TPS validation service) 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 TPS Integr8 service

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

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 telphone number is callable (i.e. not on the TPS)
    // result.TelephoneNumber
    //   Contains the original telephone number if it is callable.