Configuring Trulioo Business Verification

Trulioo Business Verification is a data provider that you can use to run the Company data check.

If you're using the full Maxsight product, you can run this check on the Identify officers, Identify shareholders and Verify company details tasks.

How it works

This is the default behavior for a variant of the Company data check with Trulioo Business Verification as the data provider.

Trulioo Business Verification runs the check using the country of incorporation and the company name or company number. Some jurisdictions may also require the state of incorporation.

Note that ongoing company monitoring is not supported.

The check passes when all of the following are true:

The company name is found in the registry.
The company status in the registry is active.
The company number from the profile matches the number in the registry.

When the check passes, the company, shareholder, and officer information is imported into the check results. The check returns a partial match when the company number or name is not matched in the registry, but other fields are matched or marked as active, or when the name and number are matched but the company status is Inactive. The check fails if the company name and number are not found or the state of incorporation is required but not present.

Trulioo Business Verification collects information from multiple sources. By default, Maxsight prioritizes a comprehensive view data source, which combines data from multiple providers. This matches what users typically see in the Trulioo portal.

Maxsight doesn't use Trulioo's RecordStatus to determine the overall check result.

You can search for companies in Trulioo Business Verification using the company name.

Trulioo Business Verification supports more than 200 countries. For a full list of supported countries, contact your Trulioo account manager.

Configuration options

You can configure how Maxsight prioritizes data sources when using Trulioo Business Verification.

How data sources are prioritized

By default, Maxsight selects the Enable Comprehensive View Data Source option which means:

First, Maxsight uses the comprehensive view, which is consolidated data from multiple data source providers, showing information more aligned with what you see in the Trulioo portal.
If that fails, Maxsight uses the D&B enhanced credit search and other available sources.

When the Enable Comprehensive View Data Source is not selected:

First, Maxsight uses the D&B enhanced credit search.
Then Maxsight uses a government registry search and other available sources.

Maxsight first tries to match the business registration number with your input data. If Maxsight can't find a match for the business number, it selects data from the first available source in the priority order.

For Maxsight to use a data source, the source must include:

BusinessRegistrationNumber/DUNSNumber
AppendedFields
DatasourceFields

Maxsight skips sources that do not have these fields.

Your contract with Trulioo determines which data sources you can access, and your Trulioo configuration determines their order.

Search feature

The company search allows users to search for companies using the following parameters:

Company name

The search is performed within Maxsight, using data provided by Trulioo.

Search results are ranked and returned by combining data from every data source, sorting them by MatchingScore field, and returning responses after de-duplication.

The search endpoint has the following requirements:

Country of incorporation is required
Company name is required
Value length should be greater than 1
State is required for specific countries such as the USA, Canada, and Australia.

Country-specific requirements:

USA/Canada/Australia: State of incorporation is a required field.

What we'll need

Let us know that you'd like to add a variant of the Company data check with Trulioo Business Verification and we will set it up.

We will need your Trulioo Business Verification:

Username
Password

For help getting your username and password, speak to your Trulioo Business Verification account manager.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

Is company information returned from Trulioo Business Verification?
Create a company profile with Company 1 as the name and 1 as the company number with country of incorporation GBR, and run the check variant. If the check passes and data is displayed in the check results, the check variant is working as expected.
Is a partial match returned when the company number is found in Trulioo Business Verification's sources but the profile data does not match?
Create a company profile with Company 12 as the name and 12 as the company number, and run the check variant. If the check returns a partial match and an incorrect company number is displayed in the results, the check variant is working as expected.
Does the check fail when the company number cannot be found in Trulioo Business Verification's sources?
Create a company profile with Company 8 as the name and 8 as the company number, and run the check variant. If the check fails and no results are returned, the check variant works as expected.

Required profile fields

These are the profile details searched in the Trulioo Business Verification's sources:

Maxsight name	Description	Trulioo field details
Name	`metadata.name`	`AppendedFields.BusinessName`
Company number	`metadata.number`	`BusinessRegistrationNumber`
Country of incorporation (+ state of incorporation where required for that country)	`metadata.country_of_incorporation`	`CountryCode` (+ `JurisdictionOfIncorporation`)

Data mapping

Once check data is returned from the Trulioo Business Verification, Maxsight will map the following data to our own data structure.

Maxsight name	Maxsight API name	Trulioo field details
Company status	`is_active`	`AppendedFields.BusinessStatus` Note that registered status is not considered active.
Addresses	`address`, `type`	`StandardizedLocations.Address`, or (`StandardizedLocations.BuildingNumber`, `StandardizedLocations.StreetName`, `StandardizedLocations.StreetType`) + `StandardizedLocations.PostalCode` + `StandardizedLocations.City` + `StandardizedLocations.StateProvinceCode`
Incorporation date	`incorporation_date`	`StandardizedLocations.YearOfIncorporation` + `StandardizedLocations.MonthOfIncorporation` + `StandardizedLocations.DayOfIncorporation`
Nature of business	`industry_classifications`	`StandardizedIndustries.CodeType` + `StandardizedIndustries.Code` + `StandardizedIndustries.Description`

Note that postal_code and locality are sometimes required fields in queries to certain jurisdictions. If they are available as part of a company's profile, they will be sent as part of the request. These are sent as PostalCode and City.
A number of fields are not returned consistently by Trulioo and, therefore have not been mapped. These are company type, legal structure and shares.

Data mapping for associates

For associates, Maxsight will combine the data from both the StandardizedDirectorsOfficers and StandardizedCompanyOwnershipHierarchy array returned by Trulioo Business Verification.

By default, Entities, EnhancedProfile, and Filings are set to true in the request to Trulioo Business Verification.

Maxsight name	Maxsight API name	Trulioo field name
Entity type	`entity_type`	`Type/BusinessEntityType` Note that if an entity is unknown, with no given name or surname, it is considered a company.
Name	`immediate_data.personal_details.name`	`GivenName`, `Surname`, `FullName`
Address	`immediate_data.metadata.addresses[0] or .address_history[0]`	`FullAddress` Note that If country is not present, or mapped from field `CountryCode`), then address for the entity would still be populated, but with `CountryCode` as ZZZ.
Role	`relationships.associated_role`	`Position` (1st priority), `Designation` (StandardizedDirectors), `BusinessEntityType` (Standardized Company Ownerships Hierarchy) Note that the default value is OTHER.
Original role	`relationships.original_role`	`Position` (1st priority), `Designation` (StandardizedDirectors), `BusinessEntityType` (Standardized Company Ownerships Hierarchy) Note that the default value is OTHER.
Tenure start/end	`Relationships.tenure.start`, `Relationships.tenure.end`	`StartDate`, `EndDate`
Shareholding percentage	`relationships.shareholdings.percentage`	`BeneficialOwnershipPercentage` (Beneficial owner) or `DirectOwnershipPercentage`/`IndirectOwnershipPercentage` (Shareholder)

If an associate is both a director and also a shareholder Trulioo Business Verification will return them as two separate entities.

Associates who are persons of significant control appear in the Identify officers task. They are also listed under the Ownership section in the Trulioo report.

In this section: