0151 355 4555



Checks to see if a telephone number match can be made for this record. If it can then it returns a DirectoryLookupResult which contains details of the record within BT OSIS.

By default the matching will be performed at Surname level (i.e. a match will be allowed if the surname matches regardless of the title or forename passed in). This can be overriden by specifying the option MatchLevel.



  • true - This uses the Electoral Roll to try and search for cohabitation. It is relatively common these days for households to be made up of several different surnames (for example - unmarried cohabitation). In these situations then the telephone line will usually be listed in one of the householders' names. If your record happens to be for another name in the household then you would not normally be able to make a match. To get around this problem, we look at the Edited Electoral Roll (ER) to see if we can identify a cohabitation situation. If we can then we will search under all the names in the household to see if a telephone line is listed under any the other occupants. Please note that in order for this option to work you will need to be licenced for the Electoral Roll service and you will be charged for a Name lookup for every query made.
  • false (default) - This does not try to use Electoral Roll to search for cohabitation.


  • S (default) - This allows matching to be made at Surname level. Usually, a household will have the phone in one of the householders' names but the phone will be shared by the house. For this reason, the deault option is to allow matches at Surname level.
  • I - This forces matching to be made at Initial Level. This means that the first initial must match as well as the surname. Where no first initial is passed into the service then no match can be made. This provides a tighter match but reduces the hit-rate as it is difficult to predict which householder will have the telephone registered in thier name.

View all Telephone Number Capture (part of the identity 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 TeleAppend Integr8 service

function FindTelephoneNumber(record) {
  /// <param name="record">data8.inputrecord. Set up the Name, Address properties before calling this method.</param>
  var teleappend = new data8.teleappend();

function showFindTelephoneNumberResult(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
    //   Contains the details found for the requested person on the telephone directory.
    //   The telephone number can be extracted from the TelephoneNumber field, and the
    //   name and address can be found from the Name and Address fields respectively.