Skip to main content

Validation Suite

Overview

Experian Data Quality's Validation Suite is a tool that allows you to integrate real-time address, phone, and email validation into your website in a few easy steps.

Currently, only UK, USA, AUS and NZL addresses as well as UK, USA, CAN, AUS and NZL phone numbers, are supported.

Our validation service identifies whether:

  • an email address is valid and deliverable, allowing you to avoid emailing to harmful and invalid addresses
  • UK, USA, AUS and NZL addresses are valid and deliverable
  • UK, USA, CAN, AUS and NZL phone numbers are valid

To access the tool, log into the Self Service Portal and select Validation Suite from the Products menu. 

Address integration

Currently, the Address Validation service supports UK, USA, AUS and NZL addresses only (containing a maximum of 7 address fields). The validation service uses our Global Intuitive API enabling intuitive real-time address validation. 

Phone integration 

Our Phone Validation service supports both mobile/cell and landline UK, USA, CAN, AUS and NZL phone numbers.

UK phone numbers have to:

  • contain 10 digits or start with +44 or 44 or 0044
  • contain no special characters (except for +) 

US and CAN phone numbers have to:

  • contain 10 digits or start with +1 or 1 or 001
  • contain no special characters (except for +) 

AUS phone numbers have to: 

  • contain 9 digits or start with +61 or 61 or 0061
  • contain no special characters (except for +) 

NZL phone numbers have to:  

  • contain 8 to 9 digits or start with +64 or 64 or 0064
  • contain no special characters (except for +)


Email integration differences

Our Email Validation service can also be integrated directly via the Email Validate API.

Here's an overview of the differences between the two integrations:

Using Validation SuiteUsing Email Validate API
  • Simply add the provided integration code at the end of your web page’s source code.
  • Validation time-out is set to 5 seconds.
  • Validation result styling is provided. See validation responses for details.
  • Build your own integration code using the API.
  • Set the validation time-out manually.
  • Define the styling for validation results manually.
  • Validation responses are based on Certainty element. See API validation responses for details.

Contact form

To integrate address/phone/email validation, you have to specify the form with the email field(s) you want to be used. In most cases, this will be a registration or contact form on your website that your customers will use to enter their contact details.

To create an integration, you can either:

  • Enter the URL of the web page containing the form (e.g. http://mywebsite/contact/)

or

  • Paste the HTML code of the form you want to use starting with the <form> and ending with the </form> tags. For example:

    <form>
    <label>Name</label> <input type="text" name="forename" />
    <label>Surname</label> <input type="text" name="surname" />
    <label>Email</label> <input type="text" name="email" />
    <label>Phone</label> <input type="text" name="phone" />
    <label>Street1</label> <input type="text" name="street1" />
    <label>Street2</label> <input type="text" name="street2" />
    <label>City</label> <input type="text" name="city" />
    <label>ZIP Code</label> <input type="text" name="zipcode" />
    <label>State</label> <input type="text" name="state" />
    </form> 

Use the HTML code option if your web page is not public.

Where is the HTML code?

Right-click on the web page containing your contact form and select View page source (or View source) from the menu. Copy and paste the entire code for your page and we’ll identify all the forms on that page. 

Note that your code cannot exceed 1 MB.

What if I have more than one form on the page?

You can integrate address, phone, and email validation into up to 2 forms within a web page. To do so, ensure that each form is separate and has a unique ID. For example:

<form id=>
<label>Name</label> <input type="text" name="forename" />
<label>Surname</label> <input type="text" name="surname" />
<label>Email</label> <input type="text" name="email" />
<label>Phone</label> <input type="text" name="phone" />
<label>Street1</label> <input type="text" name="street1" />
<label>Street2</label> <input type="text" name="street2" />
<label>City</label> <input type="text" name="city" />
<label>ZIP Code</label> <input type="text" name="zipcode" />
<label>State</label> <input type="text" name="state" />
</form> 

Mapping fields

Once you've specified the form(s) you want to be used, we will automatically match your form fields to our data elements.

The mapped fields will be used for the real-time address, phone, and email validation whenever your customers enter their contact data.

Note that you will only be charged per each mapped address, phone, and email field.

You can map more than one email and phone field within a form. 


Address mapping

When mapping address fields, you have to specify an address lookup trigger - the field that will be used to initiate real-time address validation. By default, this will be the 'Address Line 1' field.

For example, if you set the ZIP/postal code as the address lookup trigger, this field will display 'Start typing an address...' text and the address validation will be activated when your customer starts typing in their ZIP/postal code. 

Currently, only UK, USA, AUS and NZL addresses are supported. For all other addresses, we recommend that you create a separate form on a different web page (as these addresses will not have our address validation integrated).

The Validation Suite allows you to map 2 address sets within a form (e.g. a billing and a delivery address). In each address set, you can map each address field only once.

We recommend that your form contains the 'Country' field with one of the following values:

  • (for UK address validation) 'United Kingdom', 'Great Britain', 'U.K.', 'UK', 'GB' or 'G.B.'. 
  • (for USA address validation) ‘United States’, ‘United States of America’, ‘USA’, ‘U.S.A’, ‘U.S.’, ‘US’, ‘America’ and ‘Estados Unidos’, ‘Estados Unidos de America’ ‘EEUU’ or ‘E.E.U.U’.
  • (for AUS address validation) ‘Australia', 'AU', 'AUS'.
  • (for NZL address validation) ‘New Zealand', 'NZ', 'NZL', 'N.Z.'.

Integration's security

We highly recommend that you specify at least one domain or sub-domain for each integration. This ensures that the integration code we provide to you is not accessible to any other websites.

Note that you can whitelist more than one domain, as long as you're using the same form on all of the pages.

To specify the permitted domain(s), simply enter the permitted URL(s). For example, www.mywebsite.com.

Integration code

The integration code is the unique code that we will provide to you. Once integrated into your website and published, the code will validate addresses, emails and phone numbers in real-time. 

Note that if you're using the integration code on multiple web pages, clicks will be deducted from the same license.

This code can be used on multiple pages, as long as it’s the same form. In other words, if you have the same contact form (e.g. for creating an account) on more than one page, you can use your unique integration code in all the pages that contain this form.

Simply add the integration code at the end of your web page's source code (before the </body> tag). For example:

...
   </form>
  </div>
 <script type="text/javascript" src="https://edqfvsvcdevstorage.blob.core.windows.net/
   realtimevalidation/a1234b56-789c-0def-gh12-ij34k5l67m89.js"></script>
 </body>
</html>

Save and publish the changes.

It might take a few minutes for the code to be activated.

Validation responses

Here are the validation responses and their descriptions.

Address validation responses

Validation responseEnd user messageAddress validation API resultCosts a click?
Verified

A green border with the 'Verified' tooltip.

The address exists and is reachable.

Yes
Unverified

A red border with the 'Unverified' tooltip.

An invalid address is supplied.

Yes
Timed out

No message to the user, the entry is accepted without validation.

Connection from the server was lost. No
Error

No message to the user, the entry is accepted without validation.

Our Address Validate API encountered an error. No

Email validation responses

Validation responseEnd user messageEmail validation API resultCosts a click?
Verified

A green border with the 'Verified' tooltip.

 

The mailbox is:

  • Verified - exists and is reachable
  • Unknown - not known to be illegitimate or disposable
Yes
Unverified

A red border with the 'Unverified' tooltip.

The mailbox could not be verified due to one of these reasons:

  • Undeliverable – the syntax of the email is incorrect, the mailbox does not exist, or mailbox is full, suspended or disabled.
  • Unreachable – the domain cannot be resolved, does not exist, has no reachable mail exchangers, is not responding to validation requests or does not have any active mail servers.
  • Illegitimate – a seed, spamtrap, black hole, technical role account or inactive domain.
  • Disposable – the domain is administered by a disposable email provider (e.g. Mailinator).
Yes
Timed out

No message to the user, the entry is accepted without validation.

Connection from the server was lost. No
Error

No message to the user, the entry is accepted without validation.

Our Email Validate API encountered an error. No

Phone validation responses

Validation responseEnd user messagePhone validation API resultCosts a click?
Verified

A green border with the 'Verified' tooltip.

The phone number exists and is reachable.

Yes
Unverified

A red border with the 'Unverified' tooltip.

An invalid number format is supplied.

Yes
Timed out

No message to the user, the entry is accepted without validation.

Connection from the server was lost. No
Error

No message to the user, the entry is accepted without validation.

Our Phone Validate API encountered an error. No

Copyright ©, 2014-2017. All rights reserved.