# Email and Phone Validation

## Introduction

To perform email and phone validation we will use Pluggable Data Processing(PDP) modules effectively leveraging the Loqate Harmony APIs. 

PDP for EMAIL:  HostedEmailValidation 

PDP for PHONE: HostedPhoneValidation 

### Email Validation

To complete email validation, HostedEmailValidation PDP can be chained within email data model to achieve a specific data cleansing exercise. 

Performs a full mailbox validation on the supplied email address.

Email Validation works GLOBALLY, however, Harmony Suite requires Default Locale to be selected.

This service calls [Loqate Harmony APIs Email Validation see API Specification](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/email-validation).

### Phone Validation

To complete phone validation, HostedPhoneValidation PDP can be chained within phone data model to achieve a specific data cleansing exercise. 

Performs Phone Validation for Australian, New\_Zealand and international numbers.

Phone Validation works GLOBALLY, however, Harmony Suite requires Default Locale to be selected. 

Note: Loqate Phone Validation requires precise international number format (ITU E.123), which includes prefix plus '+' followed by country code eg '+##'.

This service calls[ Loqate Harmony APIs Phone Validation see API Specification.](https://docs.mastersoftgroup.com/loqate-harmony-api/api-specification/phone-validation)

## Prerequisites: 

A comprehensive guide that signifies the essential requirements that needs to be met to access Email or Phone Validation.

{% content-ref url="email-and-phone-validation/prerequisites" %}
[prerequisites](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/prerequisites)
{% endcontent-ref %}

## Configurations for Phone and Email Validation:

This section provides insights into configuring the Phone Validation and Email Validation PDP setup using Harmony Management Console.

{% content-ref url="email-and-phone-validation/phone-and-email-pdp-configuration-setup" %}
[phone-and-email-pdp-configuration-setup](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/phone-and-email-pdp-configuration-setup)
{% endcontent-ref %}

## Using Phone Validation

After completing the necessary [Prerequisites](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/prerequisites) and configurations for PDPS provided in [Phone and Email PDP Configuration Setup](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/phone-and-email-pdp-configuration-setup), the system is prepared for phone and email validation runs through both Harmony Batch System and Harmony WS.

### 1. Alignment of Default Locale and 'hosted.defaultCountry' for Phone Validation Users

Phone validation users are advised to synchronize the 'Locale' parameter set in Harmony Batch System or Harmony Webservices with the [hosted.defaultCountry](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/prerequisites#id-2.-default-country-for-phone-validation) configuration. This alignment ensures seamless operation. The 'hosted.defaultCountry' parameter defines the default country for validation.

Any numbers that do not have country codes will be set to the Default Locale.

**For instance, when users perform phone validation with Australia as the default country:**

Locale: AUSTRALIA

hosted.defaultCountry: AU.

Numbers from non-Australian countries/locale will still be processed if they contain country codes prefix eg '+##'.

**Similarly, for users conducting phone validation with New Zealand as the default country:**

Locale: NEW ZEALAND

hosted.defaultCountry: NZ.

Numbers from non-Australian countries/locale will still be processed if they contain country codes prefix eg '+##'.

This alignment ensures accurate validation processes according to the specified country settings. For further clarification on 'hosted.defaultCountry', please refer details provided in [Default Country for Phone Validation.](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/prerequisites#id-2.-default-country-for-phone-validation)

### 2. Guidance on Reviewing guides

It is advisable to review the [Guides](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/guides) section, which provides explanations on phone validation and email validation enriched information. Prioritizing this section before examining the detailed sample illustrations in the following pages is recommended.

Refer [Phone Validation using Harmony Batch System](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/phone-validation-using-harmony-batch-system) /[Email Validation using Harmony Batch](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/email-validation-using-harmony-batch) for an illustration of sample batch run.

Refer [Phone Validation using Harmony WS](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/phone-validation-using-harmony-ws)/[Email Validation using Harmony WS](https://docs.mastersoftgroup.com/harmony-suite/user-guides/version-3.0.0/email-and-phone-validation/email-validation-using-harmony-ws) for an illustration of sample webservice calls.