IsValid
 

IsValid

Definition

TelephoneLineValidationStatus IsValid ( string username, string password, string number, Option[] options )

Description:

Checks a telephone number for validity.

The service returns a code indicating the status of the telephone number. This code can be one of the following values:

  • Valid - the telephone number is valid
  • Invalid - the telephone number is invalid
  • TemporaryInvalid - the telephone number is invalid, but may become valid shortly
  • NumberChanged - the telephone number is invalid, but calling it will give you a recording telling you a new number
  • Unknown - we could not determine the validity of the number
  • Error - an error occurred communicating with the telephone network
  • TimedOut - we did not get a response from the telephone network in a timely manner

In normal circumstances you should only receive the first three status codes. If you receive one of the final three status codes, we will investigate the cause and attempt to ensure it does not happen again, and you will not be charged for the query.

This service is not appropriate if you require an absolute indication that a telephone number is valid for a particular individual. In those circumstances, you should consider the use of a telephone number capture service.

View all Live Number Testing Methods

Code Samples

Language:

<!-- 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="http://webservices.data-8.co.uk/Javascript/Loader.ashx?key=your-api-key" type="text/javascript">
</script>

<script type="text/javascript">

function loadIntegr8() {
  // Load the TelephoneLineValidation Integr8 service
  data8.load('TelephoneLineValidation');
}

function IsValid(number) {
  /// <param name="number">string</param>
  var telephonelinevalidation = new data8.telephonelinevalidation();
  
  telephonelinevalidation.isvalid(
    number,
    null,
    showIsValidResult
  );
}

function showIsValidResult(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.Result
    //   Indicates if the telephone number is found to be valid.
  }
}

loadIntegr8();

</script>
Skip Navigation Links
Request handled by server S1 for client 38.107.179.217 at 23/05/2012 01:02:20