Best Practices and Help for Person Verification
This guide will walk you through the best process for building an HTML form that allows your users to submit data which is then verified through the Trulioo Platform API. The concepts and best practices are relevant for all kinds of applications, including mobile apps, pre-existing web forms, and in-house data-management software. Make sure you have collected the right information, the call to Trulioo can be inserted at any point in your code.
Field Configurations
Country Fields
Each verification request to the Trulioo Platform API contains a set of fields describing the individual being verified (eg. FirstGivenName, DayOfBirth etc..). It also includes the country for which the verification should be performed. The list of possible data fields varies by country. For example, Canada and the United States might have a StateProvince field, but a country like Singapore might not.
Get Fields
The Get Fields endpoint provides the full list of fields for a given country, including which are required by the datasources you're using.
If you're not sure which countries you're configured for, Get Country Code endpoint will return the full list of country codes for your account.
The response you get from Get Fields will vary based on the requested country, and is tailored to your account configuration. Therefore, it will tell you everything you need to know about what data fields to provide when you want to verify an identity through the Trulioo Platform.
Example Request
GET <<endpoint>>/v3/configuration/fields/{packageID}/{countryCode}
Authorization: OAuth
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
ApiClient apiClient = new ApiClient();
apiClient.setUsername("JoeNapoli_API_Demo");
apiClient.setPassword("05uZuPRCyPi!6");
ConfigurationApi configurationClient = new ConfigurationApi(apiClient);
//getFields
Object o = configurationClient.getFields("AU", "Identity Verification");
//getFieldsAsync
configurationClient.getFieldsAsync("AU", "Identity Verification", new ApiCallback<Object>() {
@Override
public void onFailure(ApiException e, int statusCode, Map<String, List<String>> responseHeaders) {
Logger.getLogger(SdkJavaV1Sample.class.getName()).log(Level.SEVERE, null, e);
}
@Override
public void onSuccess(Object result, int statusCode, Map<String, List<String>> responseHeaders) {
System.out.println(result); //To change body of generated methods, choose Tools | Templates.
}
@Override
public void onUploadProgress(long bytesWritten, long contentLength, boolean done) {
//To change body of generated methods, choose Tools | Templates.
}
@Override
public void onDownloadProgress(long bytesRead, long contentLength, boolean done) {
//To change body of generated methods, choose Tools | Templates.
}
});
//Example Username: JoeNapoli_API_Demo, Example Password: 05uZuPRCyPi!6
var truliooClient = new TruliooApiClient("JoeNapoli_API_Demo", "05uZuPRCyPi!6");
Dictionary<string, dynamic> e = await truliooClient
.Configuration.GetFieldsAsync("AU", "Identity Verification");
Trulioo provides multiple global and regional endpoints. Please choose the correct endpoint based on your business use case and your regulatory and compliance requirements. You can find more information on the Multi-Region Hosting page.
Example Response
{
"title": "DataFields",
"type": "object",
"properties": {
"PersonInfo": {
"title": "PersonInfo",
"type": "object",
"properties": {
"FirstGivenName": {
"type": "string",
"description": "First name of the individual to be verified",
"label": "First Name (名)"
},
"MiddleName": {
"type": "string",
"description": "Second given name of the individual to be verified",
"label": "Middle Name"
},
"FirstSurName": {
"type": "string",
"description": "Last name of the individual to be verified",
"label": "Last Name (姓)"
},
"ISOLatin1Name": {
"type": "string",
"description": "ISO Latin 1 Full name as it appears on passport",
"label": "Passport Full Name"
},
"DayOfBirth": {
"type": "int",
"description": "Day of birth date (ie 23 for a date of birth of 23/11/1975)",
"label": "Day Of Birth (日)"
},
"MonthOfBirth": {
"type": "int",
"description": "Month of birth date (ie 11 for a date of birth of 23/11/1975)",
"label": "Month Of Birth (月)"
},
"YearOfBirth": {
"type": "int",
"description": "Year of birth date (ie 1975 for a date of birth of 23/11/1975)",
"label": "Year Of Birth (年)"
},
"Gender": {
"type": "string",
"description": "Gender, may be 'M' for male or 'F' for female",
"label": "Gender"
},
"AdditionalFields": {
"type": "object",
"description": "Family name and given names, together as found on identification documents",
"label": "Full Name (姓名)",
"properties": {
"title": "AdditionalFields",
"type": "object",
"properties": {
"FullName": {
"type": "string",
"description": "Family name and given names, together as found on identification documents",
"label": "Full Name (姓名)"
}
},
"required": [
"FullName"
]
}
}
},
"required": [
"FirstGivenName",
"FirstGivenName",
"FirstSurName",
"FirstSurName",
"AdditionalFields",
"ISOLatin1Name"
]
},
"Location": {
"title": "Location",
"type": "object",
"properties": {
"BuildingNumber": {
"type": "string",
"description": "Building number of home address",
"label": "Building Number (楼房号码)"
},
"BuildingName": {
"type": "string",
"description": "Building name of home address",
"label": "Building Name (楼房名称)"
},
"UnitNumber": {
"type": "string",
"description": "Flat/Unit/Apartment number of primary residence",
"label": "Unit Number"
},
"StreetName": {
"type": "string",
"description": "Street name of primary residence",
"label": "Street Name (街道名称)"
},
"StreetType": {
"type": "string",
"description": "Street type of primary residence (Typically St, Rd etc)",
"label": "Street Type (街道种类)"
},
"City": {
"type": "string",
"description": "City of home address",
"label": "City (城市)"
},
"Suburb": {
"type": "string",
"description": "City or Suburb of primary residence",
"label": "Suburb"
},
"County": {
"type": "string",
"description": "County of home address",
"label": "County (县)"
},
"StateProvinceCode": {
"type": "string",
"description": "State or Province",
"label": "State Province"
},
"PostalCode": {
"type": "string",
"description": "ZIP Code or Postal Code of primary residence",
"label": "Postal Code"
},
"POBox": {
"type": "string",
"description": "Post Office Box",
"label": "PO Box"
},
"AdditionalFields": {
"type": "object",
"description": "Street address of primary residence",
"label": "Address 1",
"properties": {
"title": "AdditionalFields",
"type": "object",
"properties": {
"Address1": {
"type": "string",
"description": "Street address of primary residence",
"label": "Address 1"
}
},
"required": []
}
}
},
"required": []
},
"Communication": {
"title": "Communication",
"type": "object",
"properties": {
"Telephone": {
"type": "string",
"description": "Telephone number of the individual to be verified",
"label": "Telephone (固定电话号码)"
},
"EmailAddress": {
"type": "string",
"description": "Email Address",
"label": "Email Address"
}
},
"required": [
"EmailAddress"
]
},
"NationalIds": {
"title": "NationalIds",
"type": "object",
"properties": {
"Number": {
"type": "string"
},
"Type": {
"type": "string",
"value": "nationalid"
},
"DistrictOfIssue": {
"type": "string",
"description": "District where document was issued",
"label": "District Of Issue (发证区)"
},
"CityOfIssue": {
"type": "string",
"description": "City where document was issued",
"label": "City Of Issue (发证城市)"
},
"ProvinceOfIssue": {
"type": "string",
"description": "Province where document was issued",
"label": "Province Of Issue (发证省)"
},
"CountyOfIssue": {
"type": "string",
"description": "County where document was issued",
"label": "County Of Issue (发证县)"
}
},
"required": [
"ProvinceOfIssue",
"nationalid"
]
},
"Passport": {
"title": "Passport",
"type": "object",
"properties": {
"Mrz1": {
"type": "string",
"description": "First line of the Machine Readable Zone (MRZ) of passport, 44 letters and digits, i.e. 'P<CZESPECIMEN<<VZOR<<<<<<<<<<<<<<<<<<<<<<<<<'",
"label": "Passport MRZ Line 1 (护照第一行MRZ)"
},
"Mrz2": {
"type": "string",
"description": "Second line of the Machine Readable Zone (MRZ) of passport, 44 letters and digits, i.e. '99003853<1CZE1101018M1207046110101111<<<<<94'",
"label": "Passport MRZ Line 2 (护照第二行MRZ)"
},
"Number": {
"type": "string",
"description": "Passport number of the individual to be verified",
"label": "Passport Number (护照号)"
},
"DayOfExpiry": {
"type": "int",
"description": "Day of month of expiration of passport, 2 digits, i.e. '14'",
"label": "Passport Day Of Expiry"
},
"MonthOfExpiry": {
"type": "int",
"description": "Month of year of expiration of passport, 2 digits, i.e. '08'",
"label": "Passport Month Of Expiry"
},
"YearOfExpiry": {
"type": "int",
"description": "Year of expiration of passport, 4 digits, i.e. '1980'",
"label": "Passport Year Of Expiry"
}
},
"required": [
"Mrz1",
"Mrz2"
]
},
"Business": {
"title": "Business",
"type": "object",
"properties": {
"BusinessName": {
"type": "string",
"description": "The Primary or Registered name of the business",
"label": "Business Name"
},
"BusinessRegistrationNumber": {
"type": "string",
"description": "Registration number of a business to be verified",
"label": "Business Registration Number"
},
"DayOfIncorporation": {
"type": "int",
"description": "Day of Incorporation date",
"label": "Day Of Incorporation"
},
"MonthOfIncorporation": {
"type": "int",
"description": "Month of Incorporation date",
"label": "Month Of Incorporation"
},
"YearOfIncorporation": {
"type": "int",
"description": "Year of Incorporation date",
"label": "Year Of Incorporation"
},
"JurisdictionOfIncorporation": {
"type": "string",
"description": "Jurisdiction Of Incorporation",
"label": "Jurisdiction Of Incorporation"
},
"ShareholderListDocument": {
"type": "boolean",
"description": "Retrieve the shareholder list document of a company from the Government Registry",
"label": "Shareholder List Document"
}
},
"required": [
"BusinessName",
"BusinessRegistrationNumber"
]
},
"CountrySpecific": {
"title": "CountrySpecific",
"type": "object",
"properties": {
"CN": {
"title": "CN",
"type": "object",
"properties": {
"PassportMRZLine1": {
"type": "string",
"description": "First line of the Machine Readable Zone (MRZ) of passport, 44 letters and digits, i.e. 'P<CZESPECIMEN<<VZOR<<<<<<<<<<<<<<<<<<<<<<<<<'",
"label": "Passport MRZ Line 1 (护照第一行MRZ)"
},
"PassportMRZLine2": {
"type": "string",
"description": "Second line of the Machine Readable Zone (MRZ) of passport, 44 letters and digits, i.e. '99003853<1CZE1101018M1207046110101111<<<<<94'",
"label": "Passport MRZ Line 2 (护照第二行MRZ)"
},
"PassportDayOfExpiry": {
"type": "string",
"description": "Day of month of expiration of passport, 2 digits, i.e. '14'",
"label": "Passport Day Of Expiry"
},
"PassportMonthOfExpiry": {
"type": "string",
"description": "Month of year of expiration of passport, 2 digits, i.e. '08'",
"label": "Passport Month Of Expiry"
},
"PassportNumber": {
"type": "string",
"description": "Passport number of the individual to be verified",
"label": "Passport Number (护照号)"
},
"PassportYearOfExpiry": {
"type": "string",
"description": "Year of expiration of passport, 4 digits, i.e. '1980'",
"label": "Passport Year Of Expiry"
}
},
"required": [
"PassportMRZLine1",
"PassportMRZLine2"
]
}
}
}
}
}
Required Fields
The lists of required fields received from Get Fields are made up of a combination of mandatory fields across multiple datasources. Therefore when sending a verification request to the Trulioo Platform, you do not necessarily have to include all the fields for the requested country. However, if a datasource does not receive an input which it requires the verification will not be run against that particular datasource.
This will result in a 1001 error. Visit Service Level Errors for more information.
Previous Transactions
All verifications performed on the Trulioo Platform are logged as a transaction, so that each request received by the Trulioo Platform API leaves a record. The unique identifier for each record is the TransactionRecordID, which is returned as part of the Verify response. For users who want to review historical verification requests, the Trulioo Platform has three separate endpoints that access details of a particular record by ID.
Note:Trulioo provides multiple global and regional endpoints. Please choose the correct endpoint based on your business use case and your regulatory and compliance requirements. See the full list here |
---|
Get Transaction Record
Using the Get Transaction Record endpoint you can get a full record of a verify transaction (input data and resulting match signals.)
Request
GET <<endpoint>>/v3/verifications/transactionrecord/{transactionRecordID}
Authorization: OAuth
Response
{
"InputFields": [
{
"FieldName": "PostalCode",
"Value": "3108"
},
{
"FieldName": "Suburb",
"Value": "Doncaster"
},
{
"FieldName": "State",
"Value": "Victoria"
},
{
"FieldName": "YearOfBirth",
"Value": "1983"
},
{
"FieldName": "YearOfBirth",
"Value": "1983"
},
{
"FieldName": "FirstName",
"Value": "John"
},
{
"FieldName": "MiddleName",
"Value": "Henry"
},
{
"FieldName": "LastName",
"Value": "Smith"
},
{
"FieldName": "DayOfBirth",
"Value": "5"
},
{
"FieldName": "MonthOfBirth",
"Value": "3"
},
{
"FieldName": "Gender",
"Value": "M"
},
{
"FieldName": "StreetNumber",
"Value": "10"
},
{
"FieldName": "UnitNumber",
"Value": "3"
},
{
"FieldName": "StreetName",
"Value": "Lawford"
},
{
"FieldName": "StreetType",
"Value": "st"
},
{
"FieldName": "Telephone",
"Value": "03 9896 8785"
},
{
"FieldName": "EmailAddress",
"Value": "[email protected]"
},
{
"FieldName": "DriverLicenceNumber",
"Value": "076310691"
},
{
"FieldName": "DriverLicenceState",
"Value": "VIC"
},
{
"FieldName": "DayOfExpiry",
"Value": "3"
},
{
"FieldName": "MonthOfExpiry",
"Value": "4"
},
{
"FieldName": "YearOfExpiry",
"Value": "2021"
},
{
"FieldName": "PassportNumber",
"Value": "N1236548"
},
{
"FieldName": "MedicareNumber",
"Value": "5643513953"
},
{
"FieldName": "AuImmiCardNumber",
"Value": "EIS123456"
},
{
"FieldName": "CitizenshipAcquisitionDay",
"Value": "15"
},
{
"FieldName": "CitizenshipAcquisitionMonth",
"Value": "4"
},
{
"FieldName": "CitizenshipAcquisitionYear",
"Value": "1987"
},
{
"FieldName": "CountryOfBirth",
"Value": "Australia"
},
{
"FieldName": "FamilyNameAtBirth",
"Value": "Smith"
},
{
"FieldName": "MedicareColor",
"Value": "Blue"
},
{
"FieldName": "MedicareMonthOfExpiry",
"Value": "12"
},
{
"FieldName": "MedicareReference",
"Value": "2"
},
{
"FieldName": "MedicareYearOfExpiry",
"Value": "2017"
},
{
"FieldName": "PassportCountry",
"Value": "Australia"
},
{
"FieldName": "PlaceOfBirth",
"Value": "Melbourne"
},
{
"FieldName": "RegistrationNumber",
"Value": "565659"
},
{
"FieldName": "RegistrationState",
"Value": "NSW"
},
{
"FieldName": "StockNumber",
"Value": "ACD1234567"
},
{
"FieldName": "FirstInitial",
"Value": "J"
},
{
"FieldName": "MiddleInitial",
"Value": "J"
}
],
"UploadedDt": "2017-07-11T21:47:50",
"Record": {
"TransactionRecordID": "0ac8ccee-ab7a-495e-8b88-a6da1bdcb6ae",
"RecordStatus": "match",
"DatasourceResults": [
{
"DatasourceName": "Australia Citizen File",
"DatasourceFields": [
{
"FieldName": "BuildingNumber",
"Status": "match"
},
{
"FieldName": "MiddleName",
"Status": "match"
},
{
"FieldName": "StreetName",
"Status": "match"
},
{
"FieldName": "UnitNumber",
"Status": "match"
},
{
"FieldName": "Suburb",
"Status": "match"
},
{
"FieldName": "StreetType",
"Status": "match"
},
{
"FieldName": "Telephone",
"Status": "match"
},
{
"FieldName": "DayOfBirth",
"Status": "match"
},
{
"FieldName": "FirstSurName",
"Status": "match"
},
{
"FieldName": "StateProvinceCode",
"Status": "match"
},
{
"FieldName": "MonthOfBirth",
"Status": "match"
},
{
"FieldName": "PostalCode",
"Status": "match"
},
{
"FieldName": "FirstInitial",
"Status": "match"
},
{
"FieldName": "YearOfBirth",
"Status": "match"
},
{
"FieldName": "FirstGivenName",
"Status": "match"
},
{
"FieldName": "MiddleInitial",
"Status": "match"
}
],
"AppendedFields": [],
"Errors": [],
"FieldGroups": []
},
{
"DatasourceName": "Australia Driver Licence",
"DatasourceFields": [
{
"FieldName": "DriverLicenceDayOfExpiry",
"Status": "match"
},
{
"FieldName": "FirstInitial",
"Status": "match"
},
{
"FieldName": "StreetType",
"Status": "match"
},
{
"FieldName": "DriverLicenceMonthOfExpiry",
"Status": "match"
},
{
"FieldName": "FirstGivenName",
"Status": "match"
},
{
"FieldName": "UnitNumber",
"Status": "match"
},
{
"FieldName": "DriverLicenceYearOfExpiry",
"Status": "match"
},
{
"FieldName": "FirstSurName",
"Status": "match"
},
{
"FieldName": "PostalCode",
"Status": "match"
},
{
"FieldName": "DriverLicenceNumber",
"Status": "match"
},
{
"FieldName": "DayOfBirth",
"Status": "match"
},
{
"FieldName": "StateProvinceCode",
"Status": "match"
},
{
"FieldName": "DriverLicenceState",
"Status": "match"
},
{
"FieldName": "MonthOfBirth",
"Status": "match"
},
{
"FieldName": "Suburb",
"Status": "match"
},
{
"FieldName": "StreetName",
"Status": "match"
},
{
"FieldName": "YearOfBirth",
"Status": "match"
},
{
"FieldName": "RTACardNumber",
"Status": "match"
},
{
"FieldName": "BuildingNumber",
"Status": "match"
}
],
"AppendedFields": [],
"Errors": [],
"FieldGroups": []
},
{
"DatasourceName": "Australia Historical File",
"DatasourceFields": [
{
"FieldName": "StreetName",
"Status": "match"
},
{
"FieldName": "FirstInitial",
"Status": "match"
},
{
"FieldName": "BuildingNumber",
"Status": "match"
},
{
"FieldName": "FirstGivenName",
"Status": "match"
},
{
"FieldName": "StreetType",
"Status": "match"
},
{
"FieldName": "FirstSurName",
"Status": "match"
},
{
"FieldName": "Suburb",
"Status": "match"
},
{
"FieldName": "MiddleInitial",
"Status": "match"
},
{
"FieldName": "Telephone",
"Status": "match"
},
{
"FieldName": "MiddleName",
"Status": "match"
},
{
"FieldName": "UnitNumber",
"Status": "match"
},
{
"FieldName": "PostalCode",
"Status": "match"
},
{
"FieldName": "StateProvinceCode",
"Status": "match"
}
],
"AppendedFields": [],
"Errors": [],
"FieldGroups": []
},
{
"DatasourceName": "Visa Verification",
"DatasourceFields": [
{
"FieldName": "YearOfBirth",
"Status": "match"
},
{
"FieldName": "PassportNumber",
"Status": "match"
},
{
"FieldName": "PassportCountry",
"Status": "match"
},
{
"FieldName": "FirstGivenName",
"Status": "match"
},
{
"FieldName": "FirstSurName",
"Status": "match"
},
{
"FieldName": "MiddleName",
"Status": "match"
},
{
"FieldName": "DayOfBirth",
"Status": "match"
},
{
"FieldName": "FirstInitial",
"Status": "match"
},
{
"FieldName": "MonthOfBirth",
"Status": "match"
},
{
"FieldName": "MiddleInitial",
"Status": "match"
}
],
"AppendedFields": [],
"Errors": [],
"FieldGroups": []
}
],
"Errors": []
},
"Errors": []
}
Supported ID Types
For the Trulioo Platform Verify call one of the input fields provided is DataFields.NationalIds.Type. For this field we have multiple types that are available. A break down of these ID types is as follows.
Supported Types: National ID, Health, Social Service, Tax ID Number, Country Specific
National ID
Country | National ID |
---|---|
Argentina | Documento Nacional de Identidad (DNI) National ID |
Bahrain | Bahrain Identification Number |
Bangladesh | National ID card |
Brazil | Cadastro de Pessoas Físicas (CPF) - for individuals, doubles as National ID |
Chile | Tax Identification Number (RUT) Rol Único Nacional (RUN) (RUN = RUT for residents) |
China | Chinese ID TIN (if no Chinese ID) |
Colombia | NUIP (Número Único de Identidad Personal) / Cédula de Identidad |
Costa Rica | Cédula de Identidad |
Denmark | CPR number |
Dominican Republic | Dominican national identity card (cédula, SSN) |
Ecuador | Taxpayer Unique Registry (RUC) (derived from Cédula de Identidad) |
Egypt | بطاقة تحقيق شخصية (Personal Verification Card) |
El Salvador | Numero de Identificacion Tributaria (SV-NIT) Unique Identity Document (DUI) (is being used to replace SV-NIT) |
Georgia | ეროვნული პირადობის მოწმობა (National identity card) |
Ghana | SSNIT (Social Security Number) |
Hong Kong | HKID Number |
Iceland | Kennitala |
India | Aadhaar Card Number |
Israel | Mispar Zehut (ID) |
Jordan | بطاقة شخصية (Personal card) TIN Jordan eID (looks to be replacing TIN) |
Kenya | Kitambulisho or Kenyan National Identity card |
Korea, Republic | Resident Registration Number |
Kuwait | Civil Identification Number |
Latvia | Personas kods (Personal Number) |
Lebanon | Lebanese Identity Card |
Malaysia | MyKad aka National Registration Identity Card Number (NRIC Number) |
Malta | Identity Card Number or Personal Identification Number |
Mexico | CURP ID Number |
Nigeria | National Identification Number |
Peru | Documento Nacional de Identidad (DNI) / Código Único de Identificación (CUI) |
Philippines | TIN Drivers License Philippine Identification System (PhilSys) ID / Philippine Identity Card |
Poland | PESEL |
Qatar | PIN |
Romania | Personal Identification Number (CNP) |
Russian Federation | Individual Insurance Account Number (SNILS) |
Saudi Arabia | NationalID |
Singapore | National Registration ID Card (NRIC) Number |
South Africa | ID |
Spain | Número de Identidad de Extranjero (NIE) NIF (CIF prior to 2008) - overlaps with NIE Spanish ID number (DNI) |
Sweden | Personal Identification Number (PIN) |
Thailand | Thai National ID Card |
Turkey | Türkiye Cumhuriyeti Kimlik Numarası (National Identification Number) |
Uruguay | RUT |
Venezuela | Número de Registro Único de Información Fiscal (RIF) = National ID + checksum |
Vietnam | People’s Identity Card |
Health
Country | ID |
---|---|
Australia | Medicare Number |
Social Service
Country | ID |
---|---|
Australia | Tax File Number |
Canada | Social Insurance Number (SIN) |
India | Permanent Account Number (PAN), Tax ID Number |
Italy | Codice Fiscale |
Mexico | Clave en el Registro Federal de Contribuyentes - RFC |
Philippines | Social Security System (SSS) Number |
US | Social Security Number ITIN (For those who don't have SSN) |
Tax ID Number
Country | ID |
---|---|
Argentina | Clave Única de Identificación Tributaria (CUIT) - is derived from the Documento Nacional de Identidad (DNI) National ID Codigo Unico de Identificacion Laboral (CUIL) |
Greece | TIN |
Russian Federation | INN |
Ukraine | TIN (Taxpayer Identification Number) |
Country Specific
Country | ID |
---|---|
Australia | New South Wales Birth/Marriage/Death Certificates Citizenship Certificate (Stock Number) Citizenship Automated System (CAS) Number Citizenship Certificate (Evidence Number)" Decent and adoption Extracts (Register+Entry Numbers) Decent and adoption Extracts (Client ID) Extract from Register of Births (Extract from Register of Births+Register Numbers) Immicard Driver's License Includes: - Learner - Provisional - Full licences (including heavy vehicle and motorcycle licences)Passport (Australian Passport Number) Visa (Non-Australian Passport Number) |
Ghana | Drivers License Voter ID Passport |
India | Drivers License |
Kenya | Alien Card Passport |
Nigeria | Drivers License Voter ID |
Russian Federation | Passport |
South Africa | Passport |
Address Cleansing
The Trulioo Platform Address Validation Service corrects the address for countries all over the world. It adds missing components such as a region or city, it formats the address as per local country standards, and it validates the address exists in the country to the level of building, street, city, or postal code. An address validated to the building is very precise, whereas an address validated to the postal code means the service could not validate the address to a point any closer than the geographic region of postal code.
The Trulioo Platform includes Validation codes in a Verify response where address cleansing is included. These validations can be found at the bottom of our Errors page.
Code | Description |
---|---|
3001 | State Province Changed The state/province/region in the provided address was found to be incorrect, given the other address values such as city or postal code, and has been updated to a new value. |
3002 | City Changed The city in the provided address was found to be incorrect, given other address values such as postal code, and has been updated to a new value. |
3003 | Street Info Changed The street in the provided address has been updated to a new value. |
3004 | Postal Code Changed The postal code in the provided address has been updated to a new value. |
When enabled address cleansing should give higher match rates as the chances of matching on a fully entered and corrected address are higher.