W2 Data Ekyc UK 007

W2 Data Ekyc Uk 007 Service

W2_Data_Ekyc_Uk_007 Service is an identity verification service that includes the full Electoral Roll along with credit bureau data. This service will leave a money laundering footprint on the bureau profile of the person you are requesting information about.

Contents

The following Query Data properties pertain to this service. Please note that in the SOAP request the fields should be in alphabetical order.

 

Property Name Type Length Optional/Mandatory
Forename
String
15 Mandatory
MiddleNames
String
15 Optional
Surname
String
30 Mandatory
DayOfBirth
Integer
2 Mandatory
MonthOfBirth
Integer
2 Mandatory
YearOfBirth
Integer
4 Mandatory
HouseNameNumber
String
26 Optional *
HouseName
String
26 Optional *
HouseNumber
String
26 Optional *
Flat
String
20 Optional *
Street
String
40 Optional *
Region
String
20 Optional *
County
String
20 Optional *
Country
String
20 Optional *
City
String
20 Optional *
Postcode
String
8 Optional *

After performing the search, the validation result (pass, fail, etc.) will be part of the <TransactionInformation> returned for the service call. 

  • * Address information is optional if an AddressLookupRef is supplied in the query options. The AddressLookupRef is retrieved from the W2_DATA_ADDRESS_LOOK_UP_007 service as an addressId.

  • If an AddressLookupRef is not supplied then a minimum of HouseNameNumber and Postcode are required. Though it is advised to supply as much address information as possible as this is more likely to return a match if no prematched addressId is supplied.

  • By default we include a check for Mortality Data. Users can turn this option off by adding the IncludeHaloMortalityCheck query option and setting it to false

  • Please note this setting is case sensitive, so something like includehalomortalitycheck (all lowercase) won't be picked up.

  • You can find information about the sandbox version of this service here.

Please note this is not actual data and shouldn't be used for testing and that these are not the only possible ways to query the service just some of the more common examples. 

Example 1 - An example request for an identity check. Using a prematched address id.

 <serviceRequest>
   <BundleData>
     <BundleName>{YOUR BUNDLE NAME HERE}</BundleName>
   </BundleData>
   <QueryData>
     <DayOfBirth>{e.g. 01}</DayOfBirth>
     <Forename>{e.g. JOHN}</Forename>
     <MiddleNames>{e.g. JAMES} </MiddleNames>
     <MonthOfBirth>{e.g. 01}</MonthOfBirth>
     <Surname>e.g. SMITH</Surname>
     <YearOfBirth>{e.g. 1990}</YearOfBirth>
   </QueryData>
   <QueryOptions>
     <KeyValueOfstringstring>
       <Key>{AddressLookupRef}</Key>
       <Value>{e.g. 12345}</Value>
     </KeyValueOfstringstring>
   </QueryOptions>
   <ServiceAuthorisation>
     <APIKey>{YOUR API KEY HERE}</APIKey>
     <ClientReference>{YOUR CLIENT REFERENCE HERE}</ClientReference>
   </ServiceAuthorisation>
 </serviceRequest>

Example 2 - An example request for an identity check. Using address information.

This example uses the W2 Global Data head office address.

    
    <serviceRequest>
        <BundleData>
            <BundleName>{YOUR BUNDLE NAME HERE}</BundleName>
        </BundleData>
        <QueryData>
            <City>{e.g. Cardiff }</City>
            <DayOfBirth>{e.g. 01}</DayOfBirth>
            <Forename>{e.g. JOHN}</Forename>
            <HouseNameNumber>{e.g. 1 or "Regus House"}</HouseNameNumber>
            <MiddleNames>{e.g. JAMES} </MiddleNames>
            <MonthOfBirth>{e.g. 01}</MonthOfBirth>
            <Postcode>{e.g. CF10 4RU }</Postcode>
            <Street>{e.g. Falcon Dr}</Street>
            <Surname>{e.g. SMITH}</Surname>
            <YearOfBirth>{e.g. 1990}</YearOfBirth>
        </QueryData>
        <ServiceAuthorisation>
            <APIKey>{YOUR API KEY HERE}</APIKey>
            <ClientReference>{YOUR CLIENT REFERENCE HERE}</ClientReference>
        </ServiceAuthorisation>
    </serviceRequest>        
    

Example 3 - An example request for an identity check. Excluding the mortality data.

This example uses the W2 Global Data head office address.

     
    <serviceRequest>
        <BundleData>
            <BundleName>{YOUR BUNDLE NAME HERE}</BundleName>
        </BundleData>
        <QueryData>
            <DayOfBirth>{e.g. 01}</DayOfBirth>
            <Forename>{e.g. JOHN}</Forename>
            <MiddleNames>{e.g. JAMES} </MiddleNames>
            <MonthOfBirth>{e.g. 01}</MonthOfBirth>
            <Surname>{e.g. SMITH}</Surname>
            <YearOfBirth>{e.g. 1990}</YearOfBirth>
        </QueryData>
        <QueryOptions>
            <KeyValueOfstringstring>
                <Key>{AddressLookupRef}</Key>
                <Value>{e.g. 12345}</Value>
            </KeyValueOfstringstring>
            <KeyValueOfstringstring>
                <Key>{IncludeHaloMortalityCheck}</Key>
                <Value>{false}</Value>
            </KeyValueOfstringstring>
        </QueryOptions>
        <ServiceAuthorisation>
            <APIKey>{YOUR API KEY HERE}</APIKey>
            <ClientReference>{YOUR CLIENT REFERENCE HERE}</ClientReference>
        </ServiceAuthorisation>
    </serviceRequest>
        
    

The responses below are just a few examples of possible responses there are other possible responses which may vary based on your particular bundle configuration but the examples below cover the main examples. 

Example 1 - General Response

The first example below shows the general format of the response. Please note that I have excluded any other service responses and the full SOAP envelope for brevity.

    
    <ProcessRequestResult>
        <ServiceResult>
            {other services excluded from this example}
            <W2DataEkycUk007Result>
                <IdentityCheckResult>
                    <MatchInformation>
                        <IndependantDataSources>{ true | false | null }</IndependantDataSources>
                        <NameAndAddressMatch>{ true | false }</NameAndAddressMatch>
                        <NameAndDateOfBirthMatch>{ true | false }</NameAndDateOfBirthMatch>
                    </MatchInformation>
                    <MatchResult>
{ NotChecked | TwoPlusTwo | TwoPlusOne | OnePlusOne | NoMatch }
</MatchResult> </IdentityCheckResult> </W2DataEkycUk007Result> </ServiceResult> <TransactionInformation> <InterpretResult>
{ Pass | Fail | Inconclusive | NotApplicable | NotPerformed }
</InterpretResult> <ServiceCallReference>{Call reference will be a new GUID here}</ServiceCallReference> <ServiceTransactions> <ServiceTransactionInformation> <FailedOverTo>{ only used if failovers are configured }</FailedOverTo> <HaltTriggered>{ true | false }</HaltTriggered> <Service>W2DataEkycUk007</Service> <ServiceInterpretResult>{ Pass | Fail | Inconclusive }</ServiceInterpretResult> <ServiceTransactionResult>{ Success }</ServiceTransactionResult> <ServiceTransactionResultMessage>
{ Any information pertinent to this call }
</ServiceTransactionResultMessage> <ServiceValidationDetails>
{ only filled in if there are problems with the validation}
</ServiceValidationDetails> <ValidationResult>
{ Pass | Fail | Inconclusive | NoValidationPerformed | NotApplicable }
</ValidationResult> </ServiceTransactionInformation> </ServiceTransactions> </TransactionInformation> </ProcessRequestResult>

Example 2 - Successful Response

This example shows an example of a complete two plus two check, which would give a PASS.

    
    <ProcessRequestResult>
        <ServiceResult>
            <W2DataEkycUk007Result>
                <IdentityCheckResult>
                    <MatchInformation>
                        <IndependantDataSources>true</IndependantDataSources>
                        <NameAndAddressMatch>true</NameAndAddressMatch>
                        <NameAndDateOfBirthMatch>true</NameAndDateOfBirthMatch>
                    </MatchInformation>
                    <MatchResult>TwoPlusTwo</MatchResult>
                </IdentityCheckResult>
            </W2DataEkycUk007Result>
        </ServiceResult>
        <TransactionInformation>
            <InterpretResult>Pass</InterpretResult>
            <ServiceCallReference>{e.g. 558003c3-3154-4e55-9c9e-e2dfb897b098}</ServiceCallReference>
            <ServiceTransactions>
                <ServiceTransactionInformation>
                    <FailedOverTo />
                    <HaltTriggered>false</HaltTriggered>
                    <Service>W2DataEkycUk007</Service>
                    <ServiceInterpretResult>Pass</ServiceInterpretResult>
                    <ServiceTransactionResult>Success</ServiceTransactionResult>
                    <ServiceTransactionResultMessage />
                    <ServiceValidationDetails />
                    <ValidationResult>Pass</ValidationResult>
                </ServiceTransactionInformation>
            </ServiceTransactions>
        </TransactionInformation>
    </ProcessRequestResult>
    
    

Example 3 - Inconclusive Response

This example shows an inconclusive result where we have fund both name and address and name and date of birth matches but not on different data sources.

    
    <ProcessRequestResult>
        <ServiceResult>
            <W2DataEkycUk007Result>
                <IdentityCheckResult>
                    <MatchInformation>
                        <IndependantDataSources>false</IndependantDataSources>
                        <NameAndAddressMatch>true</NameAndAddressMatch>
                        <NameAndDateOfBirthMatch>true</NameAndDateOfBirthMatch>
                    </MatchInformation>
                    <MatchResult>TwoPlusOne</MatchResult>
                </IdentityCheckResult>
            </W2DataEkycUk007Result>
        </ServiceResult>
        <TransactionInformation>
            <InterpretResult>Inconclusive</InterpretResult>
            <ServiceCallReference>{e.g. 558003c3-3154-4e55-9c9e-e2dfb897b098}</ServiceCallReference>
            <ServiceTransactions>
                <ServiceTransactionInformation>
                    <FailedOverTo />
                    <HaltTriggered>false</HaltTriggered>
                    <Service>W2DataEkycUk007</Service>
                    <ServiceInterpretResult>Inconclusive</ServiceInterpretResult>
                    <ServiceTransactionResult>Success</ServiceTransactionResult>
                    <ServiceTransactionResultMessage />
                    <ServiceValidationDetails />
                    <ValidationResult>Pass</ValidationResult>
                </ServiceTransactionInformation>
            </ServiceTransactions>
        </TransactionInformation>
    </ProcessRequestResult>
    
   

Example 4 - Failing Response

This example shows an failing result where we have not found a match.

    
    <ProcessRequestResult>
        <ServiceResult>
            <W2DataEkycUk007Result>
                <IdentityCheckResult>
                    <MatchInformation>
                        <IndependantDataSources />
                        <NameAndAddressMatch>false</NameAndAddressMatch>
                        <NameAndDateOfBirthMatch>false</NameAndDateOfBirthMatch>
                    </MatchInformation>
                    <MatchResult>NoMatch</MatchResult>
                </IdentityCheckResult>
            </W2DataEkycUk007Result>
        </ServiceResult>
        <TransactionInformation>
            <InterpretResult>Fail</InterpretResult>
            <ServiceCallReference>{e.g. 558003c3-3154-4e55-9c9e-e2dfb897b098}</ServiceCallReference>
            <ServiceTransactions>
                <ServiceTransactionInformation>
                    <FailedOverTo />
                    <HaltTriggered>false</HaltTriggered>
                    <Service>W2DataEkycUk007</Service>
                    <ServiceInterpretResult>Fail</ServiceInterpretResult>
                    <ServiceTransactionResult>Success</ServiceTransactionResult>
                    <ServiceTransactionResultMessage />
                    <ServiceValidationDetails />
                    <ValidationResult>Pass</ValidationResult>
                </ServiceTransactionInformation>
            </ServiceTransactions>
        </TransactionInformation>
    </ProcessRequestResult>
    
    

Example 5 - Additional Information Response

By default we return an Identity Check Response detailed above, we can configure your account to also return some additional information that might further clarify the response. This would include an additional <FullResponse> element under the <W2DataEkycUk007Result> element as in the example below. To configure this response please contact W2 support.

    
    <W2DataEkycUk007Result>
        <FullResponse>
            <MortalityData/>
            <MortalityDataCheckType>
                { NotChecked | FullMatch | PartialMatch | NoMatch | MultipleMatch }
            </MortalityDataCheckType>
            <UniqueAddressMatchFound>
{ true | false }
</UniqueAddressMatchFound> <VerificationData> <ElectoralRollNameAndAddressMatch>
{ true | false }
</ElectoralRollNameAndAddressMatch> <ElectoralRollNameAndDateOfBirthMatch> { NotChecked | FullMatch | PartialMatch | NoMatch | MultipleMatch } </ElectoralRollNameAndDateOfBirthMatch> <LendersContributingToTheCreditFileCount>
{ 0 - 99 }
</LendersContributingToTheCreditFileCount> <MatchDateOfBirthUsingCreditRecords> { NotChecked | FullMatch | PartialMatch | NoMatch | MultipleMatch } </MatchDateOfBirthUsingCreditRecords> <NumberCcj>
{ 0 - 99 }
</NumberCcj> </VerificationData> </FullResponse> <IdentityCheckResult> <MatchInformation> <IndependantDataSources>{ true | false | null }</IndependantDataSources> <NameAndAddressMatch>{ true | false }</NameAndAddressMatch> <NameAndDateOfBirthMatch>{ true | false }</NameAndDateOfBirthMatch> </MatchInformation> <MatchResult> { NotChecked | TwoPlusTwo | TwoPlusOne | OnePlusOne | NoMatch } </MatchResult> </IdentityCheckResult> </W2DataEkycUk007Result>

The Sandbox for the API can be used to generate fictitious responses that are pre-configured to display certain results. On this page is a complete list of the available Sandbox cases for the W2_DATA_EKYC_UK_007 service.

To use the Sandbox version of our API you need to set the Sandbox Query Option in the request to true. And query the service with any of the details below. Listed below are the details to set and the response you should expect to see (to see the details of the service response of each sandbox case, simply click on it in the table below).

 

 

Forename Surname Day Of Birth Month Of Birth Year Of Birth Flat House Name Number Street Postcode Result
Aaron Cross 20 6 1973 254 Ocean View WT1 1TD Inconclusive
Aaron John 3 8 1976 85 Ocean View WT1 1TD None
Abbie Forster 26 12 1962 241 Ocean View WT1 1TD None
Adam Davidson 12 5 1965 29 North Promenade FK14 2WX None
Ahenobarbus Michal 31 12 1944 68 RH13 3HE NotPerformed
Alice Jenkins 13 10 1983 First Floor Flat 9 Orchid Bank WT2 2DF Inconclusive
Allen Kiril 8 1 1943 99 IVT X34 None
Allison Leigh 17 4 1974 91 Brick Lane E1 6QL Pass
Anquan Error 14 5 1978 10 Error Road ER3 3OR NotPerformed
Bethany Sharp 26 7 1949 259 Wellington Road South SK2 6NG None
Bradley Oliver 15 11 1973 209 Ocean View WT1 1TD Pass
Cameron Evans 24 12 1953 Flat B 5 Orchid Bank WT2 2DF Fail
Cerys Clayton 21 4 1983 Second Floor Flat 9 Orchid Bank WT2 2DF Inconclusive
Chloe Hardy 12 1 1979 1A 1 Orchid Bank WT2 2DF Pass
Connor Error 1 2 1947 8 Error Road ER3 3OR NotPerformed
David Cameron 9 10 1966 5 BS8 1HN None
David Error 7 3 1931 3 Error Road ER3 3OR Pass
Edward Pearson 9 4 1985 253 Ocean View WT1 1TD None
Evan Duncan 5 10 1962 202 Ocean View WT1 1TD None
Faisul Miah 4 12 1977 91 Brick Lane E1 6QL Pass
Francesca Murray 2 9 1964 32 TF12 3DY Fail
Francesca Woodward 23 9 1976 127 Ocean View WT1 1TD None
Isabelle Error 15 2 1973 168 Ocean View NP1 1NP NotPerformed
Jane Error 27 7 1986 168 Ocean View NP1 1NP NotPerformed
Jennifer Sykes 13 3 1938 57 S66 6LT Inconclusive
Jonny Miles 8 1 1943 2 99 IVT X34 NotPerformed
Kelvin Thursby 25 4 1985 91 Brick Lane E1 6QL Pass
Luana Melania 11 12 1924 8 AB54 5TR Inconclusive
Madison Reynolds 1 1 1900 85 NR24 9JB Pass
Megan Crawford 5 4 1957 1B 1 Orchid Bank WT2 2DF Pass
Moray Abdiou 11 12 1924 26 LN4 7AT Pass
Nicole Williamson 12 2 1976 379 WT1 1TD None
Rob James 12 10 1983 91 Brick Lane E1 6QL Pass
Rosie Duncan 1 2 1967 40 AB41 7YW None
Samantha Abbott 23 2 1966 137 Ocean View WT1 1TD None
Scott James 17 8 1976 91 Brick Lane E1 6QL Pass
Shannon Macdonald 21 1 1962 Flat B 7 Orchid Bank WT2 2DF Pass
(Click on a sandbox case to see the service result data here)