Global identity double verification

The query functions to verify if a person's basic data is consistent. In other words, it assesses whether the name, date of birth, address, phone number, and document number indeed belong to that person.

Global Identity Verification 2x2 has an extra layer of validations because when querying a person through this service, the person will be checked against two different data sources in a single query. In other words, the basic data will be sent to two different providers and must be approved by both for the data to be considered reliable, sufficient, or insufficient.

To indicate the reliability of an individual, there are some possible combinations of data that take into account the results of both sources to define the final reliability score.

Section: globalIdentityVerifications2x2

Supported countries: Argentina, Australia*, Austria, Belgium, Brazil, Canada*, China, Denmark, Finland, France, Germany, Hong Kong*, India*, Italy, Mexico, Netherlands, Norway, Portugal, South Africa, Spain, Sweden, Switzerland, United Kingdom and United States.

Note: Australia, Canada, Hong Kong and India require authorization for consultation before being able to access the data (Onboarding process).

Parameters

Attribute	Type	Description	Mandatory
name	string	Full name of the individual.	Yes
birthDate	string	Date of birth of the individual.	Yes
address	string	Address of the individual.	Yes
phoneNumber	string	Phone number of the individual.	Yes
nationalId	string	A government-issued identification number or document.	Yes/No (Depends on the country)
zipCode	string	Zip code of the individual's address.	Yes
countryCode	string	Country code of the individual.	Yes
dateFormat	string	Date format of Birth Date.	No

Example body

body: JSON.stringify({
  workflowId: "6644843a90k8762k25929376",
  parameters: {
    name: "Mariana Oliveira",
    birthDate: "23/04/1995",
    phoneNumber: "[phone]",
    address: "Rua das Flores, 123",
    zipCode: "12345678",
    nationalId: "9876543210",
    countryCode: "BR",
    dateFormat: "dd/MM/yyyy",
  },
});

Note: Some fields returned by this API are optional and their presence cannot be guaranteed.

Schema

Attribute	Type	Description
data	object	Object containing the main data.
data.detailList	string	Details related to the query.
data.adaptation	string	Indicator of adaptation.
data.messages	array	List of messages providing details on the level of matches for each piece of data.
data.messages[].value	string	Indicates the match level of the data (Full match, No match, Partial match, etc.).
data.messages[].code	string	Code indicating the type of data analyzed (FIRSTNAME, COMPLETENAME, PHONENUMBER, etc.).
data.detailCode	string	Detailed code specific to the process or request.
data.query	object	Information about the performed query.
data.query.options	string	Internal value indicating the search type of the query.
data.reliability	string	Indicator of reliability (10, 20, 30).
data.statusCode	string	Transaction status. Check our status guide.
statusCode	string	References the status of this query only, not the entire transaction. Check our status guide

Example

{
  "data": {
    "detailList": "",
    "adaptation": "0",
    "messages": [
      {
        "value": "0;0;0;3;3;0;3;0;3;3;0;3;3;0;3;3;3;3;0;0;0;0;0;4;3",
        "code": "TEL7"
      },
      {
        "value": "1;1;1;3;3;1;3;2;3;0;0;4;3;0;3;0;0;3;0;1;1;1;1;4;3",
        "code": "GVT2"
      },
      {
        "value": "Full match was made on Complete Name",
        "code": "1MT-BR-GVT2-COMPLETENAME"
      },
      {
        "value": "Full match was made on First Initial",
        "code": "1MT-BR-GVT2-FIRSTINITIAL"
      },
      {
        "value": "Full match was made on First Name/Given Name",
        "code": "1MT-BR-GVT2-FIRSTNAME"
      },
      {
        "value": "Full match was made on Last Name/Surname ",
        "code": "1MT-BR-GVT2-LASTNAME"
      },
      {
        "value": "Full match was made on Postal Code/Zip Code",
        "code": "1MT-BR-GVT2-POSTALCODE"
      },
      {
        "value": "Full match was made on State/Province",
        "code": "1MT-BR-GVT2-PROVINCE"
      },
      {
        "value": "Datasource does not contain element Sub Premise Descriptors provided in Address Lines",
        "code": "4MT-BR-GVT2-SUBPREMISE"
      },
      {
        "value": "Datasource does not contain element Phone Number",
        "code": "4MT-BR-GVT2-PHONENUMBER"
      },
      {
        "value": "Partial match made on element Address Lines",
        "code": "3MT-BR-GVT2-ADDRESS"
      },
      {
        "value": "Full match was made on Date of Birth",
        "code": "1MT-BR-GVT2-DATEOFBIRTH"
      },
      {
        "value": "Full match was made on Day of Birth",
        "code": "1MT-BR-GVT2-DAYOFBIRTH"
      },
      {
        "value": "Full match was made on Month of Birth",
        "code": "1MT-BR-GVT2-MONTHOFBIRTH"
      },
      {
        "value": "Full match was made on Year of Birth",
        "code": "1MT-BR-GVT2-YEAROFBIRTH"
      },
      {
        "value": "Full match was made on Complete Name",
        "code": "1AU-425-COMPLETENAME"
      },
      {
        "value": "Full match was made on First Initial",
        "code": "1AU-375-FIRSTINITIAL"
      },
      {
        "value": "Full match was made on First Name/Given Name",
        "code": "1AU-350-FIRSTNAME"
      },
      {
        "value": "Full match was made on Last Name/Surname ",
        "code": "1AU-400-LASTNAME"
      },
      {
        "value": "Full match was made on Postal Code/Zip Code",
        "code": "1AU-275-POSTALCODE"
      },
      {
        "value": "Full match was made on State/Province",
        "code": "1AU-325-PROVINCE"
      },
      {
        "value": "Full match was made on Date of Birth",
        "code": "1AU-550-DATEOFBIRTH"
      },
      {
        "value": "Full match was made on Day of Birth",
        "code": "1AU-575-DAYOFBIRTH"
      },
      {
        "value": "Full match was made on Month of Birth",
        "code": "1AU-600-MONTHOFBIRTH"
      },
      {
        "value": "Full match was made on Year of Birth",
        "code": "1AU-625-YEAROFBIRTH"
      },
      {
        "value": "Partial match made on element Address Lines",
        "code": "3AU-200-ADDRESS"
      },
      {
        "value": "1AU-275-POSTALCODE;1AU-325-PROVINCE;1AU-350-FIRSTNAME;1AU-375-FIRSTINITIAL;1AU-400-LASTNAME;1AU-425-COMPLETENAME;1AU-550-DATEOFBIRTH;1AU-575-DAYOFBIRTH;1AU-600-MONTHOFBIRTH;1AU-625-YEAROFBIRTH;1MT-BR-GVT2-COMPLETENAME;1MT-BR-GVT2-DATEOFBIRTH;1MT-BR-GVT2-DAYOFBIRTH;1MT-BR-GVT2-FIRSTINITIAL;1MT-BR-GVT2-FIRSTNAME;1MT-BR-GVT2-LASTNAME;1MT-BR-GVT2-MONTHOFBIRTH;1MT-BR-GVT2-POSTALCODE;1MT-BR-GVT2-PROVINCE;1MT-BR-GVT2-YEAROFBIRTH;3AU-200-ADDRESS;3MT-BR-GVT2-ADDRESS;4MT-BR-GVT2-PHONENUMBER;4MT-BR-GVT2-SUBPREMISE;GVT2;TEL7;",
        "code": "Codes"
      },
      {
        "value": "GVT2-ND",
        "code": "MatchCodes"
      },
      {
        "value": "Full Match for 1+1 verification",
        "code": "1MT-BR-MATCHED-1+1"
      }
    ],
    "detailCode": "WS-9055217.2024.4.28.16.42.15.908",
    "query": {
      "options": "identityverify;messageverbose"
    },
    "reliability": "20"
  }
}

Validations Rules

Rule	Description
Basic information with reliable match - double verification	Indicates whether the individual's basic information (name, address, dob, document number and phone number) matches.
Basic information with sufficient match - double verification	Indicates whether the individual's basic information (name, address, dob, document number and phone number) partially matches.