GBG Developers

Guides   |   Triangulation

Triangulation

The triangulation function takes in two sets of personal details (e.g. from a Verify Person and Verify Document check) and compares them to ensure they refer to the same individual.

The minimum requirement for Triangulation is that both sets of data have a populated forename and surname and both have date of birth and/or address (i.e. one with dob and no address and the other with address and no dob is not sufficient).

The function expects that the addresses will have been through a validation / cleanse process before being used in the triangulation call.  The option on whether an address cleanse is used can be found on the Verify People and Verify Document Image API Documentation  

The function will return a result code and a description (see below table) which indicate the level of matching found between the two candidates.

Where addresses have been supplied then details of which were matched, if any, will also be returned.

 

Code Description
-1  test mode response
0  no match
10  identical data (ignoring punctuation, white space and blank address lines)
20  same address and same person (independent of address)
30  blank address (one or both), same person (independent of address)
33  address failed quality check (one or both), same person (independent of address)
35  same person (independent of address), address matching not available
40  same address, same person (by address)
50  different address, same person (independent of address)
60  same address, different person

 

By default the two records compared are the last two in the chain of the person verifications with Name, DOB, Address details (i.e. Verify people, Verify Document Image would have these details - but Verify Liveness, Verify Selfie would not have this data).  If you need to specifically triangulation against a verification record, then a 'triangulation-verification-id' can be stipulated in the header (this will allow you to do the comparison against the data you might have submitted in an earlier stage / verification).

Please view example scenarios for Triangulation below.

Data Provided Triangulation Result
Forename (Match), Surname (Match), Date of Birth (Match) and Address (Match) PASS
Forename (Match), Surname (Match) and DOB (Match) PASS
Forename (Match), Surname (Match) and Address (Match). PASS
Forename (Match), Surname (Match), DOB (Match) and Address (No Match) PASS
Forename (No Match), Surname (Match), DOB (Match) and Address (Match) REFER
Forename (Match), Surname (No Match), DOB (Match) and Address (Match) REFER
Forename (Match), Surname (Match), DOB (No Match) and Address (Match) PASS
Forename and Surname NO TRIANGULATION PERFORMED
Both checks have provided forename and surname, only one check has provided a Date of Birth NO TRIANGULATION PERFORMED
Both checks have provided forename and surname, only one check has provided an address NO TRIANGULATION PERFORMED
Both checks have provided forename and surname. Check X has provided a DOB and no Address and Check Y has provided an Address and no DOB NO TRIANGULATION PERFORMED

 

How triangulation works