Global identity 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. Through this verification, the query validates the provided set of data and classifies the reliability of the information as reliable, sufficient, or unreliable.

To indicate an individual's trustworthiness, there are several possible combinations of data to evaluate the reliability score, which can vary between 10, 20, or 30.

Section: globalIdentityVerifications

Supported Countries: Argentina, Australia*, Austria, Belgium, Brazil, Canada*, China, Chile, Colombia, Czechia, Denmark, Finland, France, Germany, Ghana, Gibraltar, Greece, Hong Kong*, India*, Indonesia, Ireland, Italy, Japan, Kenya, Luxembourg, Malaysia, Mexico, Netherlands, New Zealand, Nigeria, Norway, Philippines, Poland, Portugal, Singapore, Slovakia, South Africa, Spain, Sweden, Switzerland, Turkey, United Kingdom, United States and Vietnam.

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": "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 Last Name/Surname",
        "code": "1AU-400-LASTNAME"
      },
      {
        "value": "Full match was made on First Name/Given Name",
        "code": "1AU-350-FIRSTNAME"
      },
      {
        "value": "Full match was made on First Initial",
        "code": "1AU-375-FIRSTINITIAL"
      },
      {
        "value": "Full match was made on Complete Name",
        "code": "1AU-425-COMPLETENAME"
      },
      {
        "value": "Full match was made on Year of Birth",
        "code": "1AU-625-YEAROFBIRTH"
      },
      {
        "value": "Full match was made on Month of Birth",
        "code": "1AU-600-MONTHOFBIRTH"
      },
      {
        "value": "Full match was made on Day of Birth",
        "code": "1AU-575-DAYOFBIRTH"
      },
      {
        "value": "Full match was made on Date of Birth",
        "code": "1AU-550-DATEOFBIRTH"
      },
      {
        "value": "Partial match made on element Address Lines",
        "code": "3AU-200-ADDRESS"
      },
      {
        "value": "No match was made on Street/Thoroughfare",
        "code": "2AU-075-THOROUGHFARE"
      },
      {
        "value": "No match was made on House Number/Street Number",
        "code": "2AU-050-HOUSENUMBER"
      },
      {
        "value": "No match was made on District",
        "code": "2AU-225-DISTRICT"
      },
      {
        "value": "Full match was made on State/Province",
        "code": "1AU-325-PROVINCE"
      },
      {
        "value": "Full match was made on Postal Code/Zip Code",
        "code": "1AU-275-POSTALCODE"
      },
      {
        "value": "Full Match for 1+1 verification",
        "code": "1MT-BR-MATCHED-1+1"
      },
      {
        "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;1MT-BR-MATCHED-1+1;2AU-050-HOUSENUMBER;2AU-075-THOROUGHFARE;2AU-225-DISTRICT;3AU-200-ADDRESS;3MT-BR-GVT2-ADDRESS;4MT-BR-GVT2-PHONENUMBER;4MT-BR-GVT2-SUBPREMISE;",
        "code": "Codes"
      }
    ],
    "detailCode": "WS-2253205.2024.4.27.17.1.51.23",
    "query": {
      "options": "identityverify;messageverbose"
    },
    "reliability": "10"
  }
}

Validations Rules

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