What is Matching on Persons of Significant Control?
A new feature of business verification requests is the ability to add names of individuals and / or businesses to your verification requests. If any of these names of are found in the [Standardized Directors Officers] (https://developer.trulioo.com/docs/understanding-standardized-fields#standardized-directors-officers) or [Standardized Company Ownership Hierarchy] (https://developer.trulioo.com/docs/understanding-standardized-fields#standardized-company-ownership-hierarchy) objects, Trulioo will return a match signal for those names.
How does this help?
As part of your onboarding process for businesses, you may seek information on important individuals such as owners and directors from the companies you are establishing a relationship with. With Matching on Persons of Significant Control, you can pass these names as part of your Business Verification request. Trulioo fetches information on these individuals / businesses from underlying sources such as business registries and UBO registers and return a match signal if the names were found.
The new feature will save your teams time by avoiding the need to compare the information manually.
Matching on Persons of Significant Control in action
You can pass multiple names as part of the [Verify] (doc:step-4b-verify) request. These can be segmented individual names, full individual names or full business names.
The new object array "PeopleOfSignificantControl' should be added within the "Business" object of the request.
Request
POST <<endpoint>>/verifications/v1/verify
Authorization: Basic ACCESS_TOKEN
Content-Type: application/json
body:
{
"AcceptTruliooTermsAndConditions": true,
"CallBackUrl": "www.example.com",
"CleansedAddress": false,
"ConfigurationName": "Identity Verification",
"ConsentForDataSources": [],
"CountryCode": "CA",
"DataFields": {
"Business": {
"BusinessName": "Acme Inc.",
"BusinessRegistrationNumber": "BRN123ABC",
"JurisdictionOfIncorporation": "BC",
"DayOfIncorporation": 13,
"MonthOfIncorporation": 5,
"YearOfIncorporation": 1990,
"EnhancedProfile": true,
"Entities": true,
"PeopleOfSignificantControl": [
{
"FirstGivenName": "",
"MiddleName": "",
"FirstSurName": "",
"SecondSurname": "",
"FullName": "EUGENE JONES",
"BusinessName": ""
},
{
"FirstGivenName": "",
"MiddleName": "",
"FirstSurName": "",
"SecondSurname": "",
"FullName": "",
"BusinessName": "SNEAK PEEK LIMITED."
},
{
"FirstGivenName": "Barbara",
"MiddleName": "",
"FirstSurName": "Jones",
"SecondSurname": "",
"FullName": "",
"BusinessName": ""
}
],
"Location": {
"BuildingNumber": "123",
"UnitNumber": "6",
"StreetName": "Main",
"StreetType": "st",
"City": "Vancouver",
"StateProvinceCode": "BC",
"PostalCode": "V6M 1A3"
},
"Communication": {
"Telephone": "1 (888) 782-2912",
"EmailAddress": "[email protected]"
}
},
"VerboseMode": false
}
Response
If the "PeopleOfSignificantControl' object is included in the request, the [Verify] (doc:step-4b-verify) response will contain match signals. These will indicate whether those names were found in the [Standardized Directors Officers] (https://developer.trulioo.com/docs/understanding-standardized-fields#standardized-directors-officers) and / or [Standardized Company Ownership Hierarchy] (https://developer.trulioo.com/docs/understanding-standardized-fields#standardized-company-ownership-hierarchy) objects.
These will be available in the Appended Fields:
{
"TransactionID": "23a29398-631b-4921-a537-a594fae4fd37",
"UploadedDt": "2018-05-29T23:12:58",
"CountryCode": "CA",
"ProductName": "Identity Verification",
"Record": {
"TransactionRecordID": "fd244b13-8cfe-4235-a61a-eadcdd629859",
"RecordStatus": "match",
"DatasourceResults": [
{
"DatasourceName": "Business Insights 433673",
"DatasourceFields": [
{
"FieldName": "MonthOfIncorporation",
"Status": "match"
},
{
"FieldName": "PostalCode",
"Status": "missing"
},
{
"FieldName": "StreetType",
"Status": "missing"
},
{
"FieldName": "YearOfIncorporation",
"Status": "match"
},
{
"FieldName": "BusinessName",
"Status": "match"
},
{
"FieldName": "taxidnumber",
"Status": "missing"
},
{
"FieldName": "City",
"Status": "missing"
},
{
"FieldName": "BuildingNumber",
"Status": "missing"
},
{
"FieldName": "BusinessRegistrationNumber",
"Status": "match"
},
{
"FieldName": "Suburb",
"Status": "missing"
},
{
"FieldName": "BuildingName",
"Status": "missing"
},
{
"FieldName": "JurisdictionOfIncorporation",
"Status": "match"
},
{
"FieldName": "StateProvinceCode",
"Status": "missing"
},
{
"FieldName": "UnitNumber",
"Status": "missing"
},
{
"FieldName": "DayOfIncorporation",
"Status": "match"
},
{
"FieldName": "County",
"Status": "missing"
},
{
"FieldName": "StreetName",
"Status": "missing"
}
],
"AppendedFields": [
{
"FieldName": "JurisdictionOfIncorporation",
"Data": "BC"
},
{
"FieldName": "BusinessName",
"Data": "Acme Inc."
},
{
"FieldName": "BusinessStatus",
"Data": "Active"
},
{
"FieldName": "BusinessType",
"Data": "Corporation"
},
{
"FieldName": "EnhancedProfile",
"Data": "{\"Location\":{\"PrimaryAddress\":[{\"StreetAddressLine\":[{\"LineText\":\"1055 Hastings St W Suite 1200\"}],\"UndeliverableIndicator\":false,\"PrimaryTownName\":\"VANCOUVER\",\"TerritoryAbbreviatedName\":\"BC\",\"PostalCode\":\"V6E 2E9\",\"CountryISOAlpha2Code\":\"CA\",\"TerritoryOfficialName\":\"BRITISH COLUMBIA\",\"PremisesDetail\":[{\"PremisesAreaMeasurement\":7502,\"PremisesAreaMeasurementReliabilityText\":{\"@DNBCodeValue\":9093,\"$\":\"Estimated\"},\"PremisesAreaMeasurementUnitText\":{\"@DNBCodeValue\":3848,\"$\":\"Square Feet\"}}],\"CountryGroupName\":\"North America\",\"LatitudeMeasurement\":49.28765,\"LongitudeMeasurement\":-123.118534,\"GeographicalPrecisionText\":{\"@DNBCodeValue\":30257,\"$\":\"Street Address Centroid\"},\"RegisteredAddressIndicator\":false}]},\"Telecommunication\":{\"TelephoneNumber\":[{\"TelecommunicationNumber\":\"(778) 123-4567\",\"UnreachableIndicator\":false,\"InternationalDialingCode\":\"1\"}],\"WebPageAddress\":[{\"TelecommunicationAddress\":\"www.acme.com\"}]},\"Linkage\":{\"GlobalUltimateOrganization\":{\"PrimaryAddress\":[{\"StreetAddressLine\":[{\"LineText\":\"1055 Hastings St W Suite 1200\"}],\"UndeliverableIndicator\":false,\"PrimaryTownName\":\"VANCOUVER\",\"TerritoryAbbreviatedName\":\"BC\",\"PostalCode\":\"V6E 2E9\",\"CountryISOAlpha2Code\":\"CA\",\"TerritoryOfficialName\":\"BRITISH COLUMBIA\"}],\"DUNSNumber\":\"203111604\",\"OrganizationPrimaryName\":[{\"OrganizationName\":{\"$\":\"Acme Inc\"}}]},\"DomesticUltimateOrganization\":{\"PrimaryAddress\":[{\"StreetAddressLine\":[{\"LineText\":\"1055 Hastings St W Suite 1200\"}],\"UndeliverableIndicator\":false,\"PrimaryTownName\":\"VANCOUVER\",\"TerritoryAbbreviatedName\":\"BC\",\"PostalCode\":\"V6E 2E9\",\"CountryISOAlpha2Code\":\"CA\",\"TerritoryOfficialName\":\"BRITISH COLUMBIA\"}],\"DUNSNumber\":\"203111604\",\"OrganizationPrimaryName\":[{\"OrganizationName\":{\"$\":\"Acme Inc\"}}]},\"LinkageSummary\":{\"GlobalUltimateFamilyTreeLinkageCount\":2},\"FamilyTreeHierarchyLevel\":1},\"RegisteredDetail\":{\"LegalFormDetails\":{\"LegalFormText\":{\"$\":\"Corporation\",\"@DNBCodeValue\":451}},\"IncorporationYear\":\"2010\"},\"PrincipalsAndManagement\":{\"CurrentPrincipal\":[{\"PrincipalName\":{\"FirstName\":\"John\",\"LastName\":\"Doe\",\"FullName\":\"John Doe\",\"@type\":\"fir:IndividualNameType\"},\"JobTitle\":[{\"JobTitleText\":{\"$\":\"Board Member\"}}],\"CurrentManagementResponsibility\":[{\"ManagementResponsibilityText\":{\"$\":\"Board of Directors\",\"@ManagementResponsibilityCode\":\"A1G7\"}}],\"PrincipalIdentificationNumberDetail\":[{\"@DNBCodeValue\":24215,\"@TypeText\":\"Professional Contact Identifier\",\"PrincipalIdentificationNumber\":\"2031116042\"}]},{\"PrincipalName\":{\"FirstName\":\"Jane\",\"LastName\":\"Doe\",\"FullName\":\"Jane Doe\",\"@type\":\"fir:IndividualNameType\"},\"JobTitle\":[{\"JobTitleText\":{\"$\":\"President & Board Member\"}}],\"CurrentManagementResponsibility\":[{\"ManagementResponsibilityText\":{\"$\":\"President\",\"@ManagementResponsibilityCode\":\"A1A6\"}},{\"ManagementResponsibilityText\":{\"$\":\"Board of Directors\",\"@ManagementResponsibilityCode\":\"A1G7\"}}],\"PrincipalIdentificationNumberDetail\":[{\"@DNBCodeValue\":24215,\"@TypeText\":\"Professional Contact Identifier\",\"PrincipalIdentificationNumber\":\"2031116041\"}]}]},\"ActivitiesAndOperations\":{\"LineOfBusinessDetails\":[{\"LineOfBusinessDescription\":{\"$\":\"Miscellaneous personal services, nec, nsk\"}}],\"PrimarySICCategoryValue\":\"I\"},\"SubjectHeader\":{\"OrganizationSummaryText\":\"Miscellaneous personal services, nec, nsk\",\"DUNSNumber\":\"11111604\",\"LastUpdateDate\":{\"$\":\"2020-07-01\"},\"MarketabilityIndicator\":true,\"DUNSSelfRequestIndicator\":false},\"IndustryCode\":{\"IndustryCode\":[{\"IndustryCodeDescription\":[{\"$\":\"Consumer Services\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":9120}],\"@DNBCodeValue\":25838,\"@TypeText\":\"D&B Hoovers Industry Code\",\"IndustryCode\":{\"$\":\"1208\"},\"DisplaySequence\":1},{\"IndustryCodeDescription\":[{\"$\":\"All Other Personal Services\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":9120}],\"@DNBCodeValue\":700,\"@TypeText\":\"NAICS\",\"IndustryCode\":{\"$\":\"812990\"},\"DisplaySequence\":1},{\"IndustryCodeDescription\":[{\"$\":\"All Other Personal Services\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":9120}],\"@DNBCodeValue\":24664,\"@TypeText\":\"North American Industry Classification System 2012\",\"IndustryCode\":{\"$\":\"812990\"},\"DisplaySequence\":1},{\"IndustryCodeDescription\":[{\"$\":\"Other service activities not elsewhere classified\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":9120}],\"@DNBCodeValue\":21182,\"@TypeText\":\"UK SIC 2003\",\"IndustryCode\":{\"$\":\"93.050\"},\"DisplaySequence\":1},{\"IndustryCodeDescription\":[{\"$\":\"CONSUMER BUYING SVC\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":2121}],\"@DNBCodeValue\":3599,\"@TypeText\":\"D&B Standard Industry Code\",\"IndustryCode\":{\"$\":\"72999904\"},\"DisplaySequence\":1},{\"IndustryCodeDescription\":[{\"$\":\"Misc personal services\",\"@LanguageCode\":39,\"@IndustryCodeDescriptionLengthCode\":1441}],\"@DNBCodeValue\":399,\"@TypeText\":\"US SIC (1987)\",\"IndustryCode\":{\"$\":\"7299\"},\"DisplaySequence\":1}]},\"Financial\":{\"KeyFinancialFiguresOverview\":[{\"StatementHeaderDetails\":{\"FinancialPeriodDuration\":\"P1Y\"},\"SalesRevenueAmount\":[{\"@CurrencyISOAlpha3Code\":\"USD\",\"@ReliabilityText\":\"Modelled\",\"@UnitOfSize\":\"SingleUnits\",\"$\":1791405},{\"@CurrencyISOAlpha3Code\":\"CAD\",\"@ReliabilityText\":\"Modelled\",\"@UnitOfSize\":\"SingleUnits\",\"$\":2368916}]}]},\"OrganizationName\":{\"OrganizationPrimaryName\":[{\"OrganizationName\":{\"$\":\"Acn Inc\"}}]},\"OrganizationDetail\":{\"FamilyTreeMemberRole\":[{\"FamilyTreeMemberRoleText\":{\"@DNBCodeValue\":12775,\"$\":\"Global Ultimate\"}},{\"FamilyTreeMemberRoleText\":{\"@DNBCodeValue\":12774,\"$\":\"Domestic Ultimate\"}},{\"FamilyTreeMemberRoleText\":{\"@DNBCodeValue\":12771,\"$\":\"Headquarters\"}}],\"StandaloneOrganizationIndicator\":false,\"ControlOwnershipDate\":{\"$\":\"2004\"},\"ControlOwnershipTypeText\":{\"@DNBCodeValue\":0,\"$\":\"Unknown\"},\"BoneyardOrganizationIndicator\":false,\"OperatingStatusText\":{\"@DNBCodeValue\":9074,\"$\":\"Active\"},\"OrganizationStartYear\":\"2010\"},\"EmployeeFigures\":{\"ConsolidatedEmployeeDetails\":{\"TotalEmployeeQuantity\":15,\"EmployeeCategoryDetails\":[{\"EmployeeBasisText\":{\"@DNBCodeValue\":9064,\"$\":\"Principals\"}}],\"ReliabilityText\":{\"@DNBCodeValue\":9093,\"$\":\"Estimated\"}}},\"Assessment\":{\"CommercialCreditScore\":[{\"MarketingRiskClassText\":{\"@DNBCodeValue\":10925,\"$\":\"Low\"}}]},\"SocioEconomicIdentification\":{\"MinorityOwnedIndicator\":false,\"FemaleOwnedIndicator\":false,\"SmallBusinessIndicator\":false,\"OwnershipEthnicity\":[{\"EthnicityTypeText\":{\"@DNBCodeValue\":0,\"$\":\"Unknown\"}}]}}"
},
{
"FieldName": "BusinessDetails",
"Data": "{\"resultId\":\"104506\",\"entityName\":\"Acme Inc.\",\"entityNumber\":\"BRN123ABC\",\"normalizedEntityStatus\":\"Active\",\"jurisdiction\":\"BC\",\"formationDate\":\"1990-05-13T00:00:00\",\"normalizedEntityType\":\"Corporation\"}"
},
{
"FieldName": "BusinessRegistrationNumber",
"Data": "BRN123ABC"
},
{
"FieldName": "DayOfIncorporation",
"Data": "13"
},
{
"FieldName": "MonthOfIncorporation",
"Data": "05"
},
{
"FieldName": "YearOfIncorporation",
"Data": "1990"
},
{
"FieldName":
"PeopleOfSignificantControl",
"Data":
{"Owners": [
{
"FirstGivenName": "",
"MiddleName": "",
"FirstSurName": "",
"SecondSurname": "",
"FullName": "EUGENE JONES",
"BusinessName": "",
"FoundInDirectorsOfficers" : true,
"FoundInCompanyOwnership" : false
},
{
"FirstGivenName": "",
"MiddleName": "",
"FirstSurName": "",
"SecondSurname": "",
"FullName": "",
"BusinessName": "SNEAK PEEK LIMITED.",
"FoundInDirectorsOfficers" : false,
"FoundInCompanyOwnership" : false
},
{
"FirstGivenName": "Barbara",
"MiddleName": "",
"FirstSurName": "Jones",
"SecondSurname": "",
"FullName": "",
"BusinessName": "",
"FoundInDirectorsOfficers" : true,
"FoundInCompanyOwnership" : false
}
]
}
}
]
}
]
}
}
Matching Rules
Matching on Persons of Significant Control will default to exact matching. Contact your Customer Support Manager to configure partial matching.