v1 - Comprehensive View

What is Comprehensive View?

Trulioo gathers the information for your business verification requests from a wide variety of sources. Trulioo takes data from all these separate sources and attempts to provide a uniform view through our standardized data model. The complexity here is that any given business entity might have several different representations across the various sources we gather information from.

The goal of Comprehensive View is to collect & compare all entities we received from our various sources and determine with a level of certainty that they are in fact the same business. Once that determination has been made, we can confidently aggregate the data into a single, easy to understand view of the entity.

Why build a Comprehensive View ?

Earlier, KYB displayed responses from multiple data sources which meant your teams had to analyze these results and extract the information that was useful for your business. We wanted to simplify the process and return one single entity that we feel is the closest match to the attributes you entered.

A robust consolidation engine resulting in a single entity allows you to be confident in the accuracy and reliability of the data - no need to review multiple data source results, the Comprehensive View is the go-to source for a business verification request.

How do we consolidate responses?

Our consolidation process involves comparing a number of key attributes found in business entities to determine similarities across responses. When our consolidation engine determines that a set of business entities are the same, we move forward with our consolidation in building the Comprehensive View. These key attributes include unique identifiers like Business Registration Numbers, Tax Identification Numbers, Business Name & Addresses.

👍

Comprehensive View in action

Here is an example of our consolidation process and how we build the Comprehensive View:

Datasource A
Acme Widgets
BRN: 12345
Address: 1055 Hastings St W Suite 1200

Datasource B
Acme Widgets
BRN: 12345
Company URL: www.acmewidgets.com
EIN:78910

Datasource C
Acme Fun Widgets
BRN: 65431
Address: 100 Park Ave, New York

Comprehensive View
Acme Widgets
BRN: 12345
Address: 1055 Hastings St W Suite 1200
Company URL: www.acmewidgets.com
EIN:78910

In this example, the two entities sharing the same BRN were consolidated into a single entity representing Acme Widgets. While Datasource C was close, ‘Ace Fun Widgets’ was not included because we couldn’t match BRN or any Address data to our other sources.

This allows us to gather information from multiple data sources - Address from Datasource A, URL & EIN from Datasource B - and consolidate into a single comprehensive entity for Acme Widgets.

How to access the Comprehensive View?

In order to simplify the adoption for you, the Comprehensive View has been built to the exact same specifications as any other data source response currently found in NAPI and Portal responses. This means that all the fields that you are already receiving and expecting are present in Comprehensive View.

There are two options for how your Comprehensive View experience can be chosen - you may choose to only receive the Comprehensive View output OR keep your current output with the addition of the Comprehensive View in which case you will continue to receive responses from multiple data sources as well as the Comprehensive View.

The Comprehensive View will appear as a data source block within the [Verify] (doc:step-4b-verify) response:

{
    "TransactionID": "23a29398-631b-4921-a537-d810qwe5lm91",
    "UploadedDt": "2022-05-29T23:12:58",
    "CountryCode": "CA",
    "ProductName": "Identity Verification",
    "Record": {
        "TransactionRecordID": "fd244b13-8cfe-4235-a61a-klairb182453",
        "RecordStatus": "match",
        "DatasourceResults": [
            {
                "DatasourceName": "Comprehensive View",
                "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 Widgets"
                    },
                    {
                        "FieldName": "BusinessStatus",
                        "Data": "Active"
                    },
                    {
                        "FieldName": "BusinessLegalForm",
                        "Data": "Private Limited Company"
                    },
                    {
                        "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": "12345"
                    },
                    {
                        "FieldName": "DayOfIncorporation",
                        "Data": "13"
                    },
                    {
                        "FieldName": "MonthOfIncorporation",
                        "Data": "06"
                    },
                    {
                        "FieldName": "YearOfIncorporation",
                        "Data": "1990"
                    }
                ],
              { "Errors": [],
                "FieldGroups": []
              }

Comprehensive View Troubleshooting

There may be occasions where you might encounter issues while having the Comprehensive View feature enabled.
Note: Even if you run into one of the following issues and a Comprehensive View could not be produced, the related data source results will still be present & available.

Message CodeMessage DescriptionExplanation
1001Business Name is a required input for a comprehensive entityBusiness name was not provided as input. Running the transaction again with a business name should resolve this.
1001Business Registration Number or Tax ID Number is a required input for a comprehensive entityAn identifier like BRN or TaxID is required for a Comprehensive View.
Running the transaction again with an appropriate ID should resolve this.
1001Jurisdiction is a required input for a comprehensive entityFor Canada, US, and Germany a Jurisdiction of Incorporation is a required input for a Comprehensive View.
1003Configuration ErrorInternal Configuration Error. Please contact [Customer Support] (mailto:[email protected])
1003None of the returned datasources could be used for a comprehensive entityNone of the returned results met the criteria to be considered for our Comprehensive View.