Once you have the business name and registration number, you can perform a [Business Verification] (ref:business-verification-verify). Note that the business verification will be executed based on the input provided. Depending on the country and datasource group(s) configured, there could be multiple entities that are returned as results due to varying levels of similarity with the input provided.
Sandbox Accounts
If you are configured for a sandbox account make sure to call Get Test Entities to get test data for a country you want to try. Sandbox accounts only use these test entities and so trying to verify with any other data will result in no matches being found.
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
},
"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
}
Verify Additional Names & Addresses
You can now submit a second name and second address for some supported countries. For more information, click [here] (doc:verifying-additional-names-addresses).
Depending on your need, you could opt for the following types of business verification details:
Essentials:
This will include matching status and essential data for vitals such as the business’ name, registration number, address / location and status. This ideal for verifying the essential information of the company.
In order to do a Business Essentials verification, the Business block of the Verify request should have the following parameters set to:
- "EnhancedProfile": false
- "Entities": false
Insights:
In addition to the matching status and data received for Essentials verification requests, Business Insights verification requests will also include additional information such as business activities, industry code as well as details for the first level of ownership. This is ideal for getting insights on direct owners, directors, managers etc.
In order to do a Business Insights verification, the Business block of the Verify request should have the following parameters set to:
- "EnhancedProfile": true
- "Entities": false
Ownership Tree:
The Ownership Tree Verify request can be used when more detailed information is required on the Ultimate Beneficial Owners and to conduct due diligence. The response to this type of Verify request will include information beyond the first level of ownership. This is in addition to information received from the Enhanced verification results.
In order to do an Ownership Tree business verification, the Business block of the Verify request should have the following parameters set to:
- "EnhancedProfile": true
- "Entities": true
These offerings vary based on your account configuration as well as the country the verification is being conducted in. For more information, reach out to your account manager or the Trulioo Sales team.
Important
Some datasources may return data at a later time. The callback URL is the endpoint set for such [asynchronous responses] (ref:asynchronous-requests) from GlobalGateway. If set, the transaction will run asynchronously and GlobalGateway will try to update you with transaction state updates until completed.
Response
{
"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"
}
],
"Errors": [],
"FieldGroups": []
},
{
"DatasourceName": "International Watchlist",
"DatasourceFields": [
{
"FieldName": "BusinessName",
"Status": "missing"
}
],
"AppendedFields": [
{
"FieldName": "WatchlistState",
"Data": "Clear"
}
],
"Errors": [],
"FieldGroups": []
},
{
"DatasourceName": "Business Insights 480052",
"DatasourceFields": [
{
"FieldName": "BuildingNumber",
"Status": "match"
},
{
"FieldName": "POBox",
"Status": "missing"
},
{
"FieldName": "City",
"Status": "match"
},
{
"FieldName": "BusinessRegistrationNumber",
"Status": "match"
},
{
"FieldName": "BuildingName",
"Status": "missing"
},
{
"FieldName": "Telephone",
"Status": "missing"
},
{
"FieldName": "Suburb",
"Status": "missing"
},
{
"FieldName": "JurisdictionOfIncorporation",
"Status": "match"
},
{
"FieldName": "UnitNumber",
"Status": "match"
},
{
"FieldName": "DayOfIncorporation",
"Status": "match"
},
{
"FieldName": "StateProvinceCode",
"Status": "match"
},
{
"FieldName": "StreetName",
"Status": "match"
},
{
"FieldName": "MonthOfIncorporation",
"Status": "match"
},
{
"FieldName": "County",
"Status": "missing"
},
{
"FieldName": "StreetType",
"Status": "match"
},
{
"FieldName": "YearOfIncorporation",
"Status": "match"
},
{
"FieldName": "PostalCode",
"Status": "match"
},
{
"FieldName": "BusinessName",
"Status": "match"
},
{
"FieldName": "Source",
"Status": "missing"
}
],
"AppendedFields": [
{
"FieldName": "City",
"Data": "Vancouver"
},
{
"FieldName": "BusinessName",
"Data": "Acme Inc."
},
{
"FieldName": "PostalCode",
"Data": "V6M 1A3"
},
{
"FieldName": "BusinessStatus",
"Data": "Active"
},
{
"FieldName": "BusinessDetails",
"Data": "{\"CompanyName\":\"Acme Inc.\",\"RegistrationNumber\":\"BRN123ABC\",\"CompanyStatus\":\"Active\",\"RegisteredFullAddress\":\"123 Main St, Vancouver, V6M 1A3\",\"RegisteredAddress\":{\"street_address\":\"123 Main St\",\"locality\":\"Vancouver\",\"region\":\"BC\",\"postal_code\":\"V6M 1A3\",\"country\":\"CA\"},\"CountryCode\":\"ca\",\"DayOfIncorporation\":\"13\",\"MonthOfIncorporation\":\"05\",\"YearOfIncorporation\":\"1990\",\"Source\":\"https://www.realsource.com/data.html?corpId=BRN123ABC\",\"AdditionalData\":{\"dissolution_date\":null,\"company_type\":\"Corporation\",\"branch\":null,\"branch_status\":null,\"inactive\":false,\"created_at\":\"2015-12-15T23:28:19+11:00\",\"updated_at\":\"2018-05-02T16:43:43+10:00\",\"retrieved_at\":\"2017-02-25T21:41:28+11:00\",\"source\":{\"publisher\":\"Corporations Canada\",\"url\":\"https://www.realsource.com/data.html?corpId=F154630\",\"retrieved_at\":\"2017-02-25T21:41:28+11:00\"},\"agent_name\":null,\"alternative_names\":[],\"previous_names\":[],\"number_of_employees\":null,\"native_company_number\":null,\"industry_codes\":[],\"identifiers\":[{\"identifier\":{\"uid\":\"859486577RC0001\",\"identifier_system_code\":\"ca_bn\",\"identifier_system_name\":\"Canadian Business Number\"}}],\"trademark_registrations\":[{\"trademark_registration\":{\"mark_details\":{\"mark_text\":\"secretstuff\",\"mark_image_url\":\"https://www.realsource.com/data.html\"},\"register_name\":\"United States Patent and Trademark Office\",\"registration_date\":\"2015-08-25\",\"expiry_date\":null}},{\"trademark_registration\":{\"mark_details\":{\"mark_text\":\"copyrights\",\"mark_image_url\":\"https://www.realsource.com/data.html\"},\"register_name\":\"United States Patent and Trademark Office\",\"registration_date\":\"2015-08-25\",\"expiry_date\":null}},{\"trademark_registration\":{\"mark_details\":{\"mark_text\":\"Brand Name\",\"mark_image_url\":\"https://www.realsource.com/data.html"},\"register_name\":\"United States Patent and Trademark Office\",\"registration_date\":\"2015-02-24\",\"expiry_date\":null}}],\"corporate_groupings\":[],\"data\":null,\"financial_summary\":null,\"home_company\":null,\"controlling_entity\":null,\"ultimate_beneficial_owners\":[],\"filings\":[],\"officers\":[{\"officer\":{\"id\":19371865,\"name\":\"John Bob\",\"position\":\"director\",\"uid\":null,\"start_date\":null,\"end_date\":null,\"occupation\":null,\"inactive\":false,\"current_status\":null,\"address\":\"123 West 9st\\nVancouver BC V8W 1P0\\nCanada\",\"nationality\":null,\"date_of_birth\":null}},{\"officer\":{\"id\":177852560,\"name\":\"Mary Berry\",\"position\":\"director\",\"uid\":null,\"start_date\":null,\"end_date\":null,\"occupation\":null,\"inactive\":false,\"current_status\":null,\"address\":\"123 - a different avenue\\nLangley BC V8U 3K7\\nCanada\",\"nationality\":null,\"date_of_birth\":null}},{\"officer\":{\"id\":19397462,\"name\":\"David O'Leary\",\"position\":\"director\",\"uid\":null,\"start_date\":null,\"end_date\":null,\"occupation\":null,\"inactive\":false,\"current_status\":null,\"address\":\"#6- The Place\\nSan Francisco CA 68716\\nUnited States\",\"nationality\":null,\"date_of_birth\":null}},{\"officer\":{\"id\":193546563,\"name\":\"Samantha Stafford\",\"position\":\"director\",\"uid\":null,\"start_date\":null,\"end_date\":null,\"occupation\":null,\"inactive\":false,\"current_status\":null,\"address\":\"35 West East Street\\nVancouver BC V0G 8P0\\nCanada\",\"nationality\":null,\"date_of_birth\":null}},{\"officer\":{\"id\":1574146,\"name\":\"Amanda Anaconda\",\"position\":\"director\",\"uid\":null,\"start_date\":null,\"end_date\":null,\"occupation\":null,\"inactive\":false,\"current_status\":null,\"address\":\"41 Up Down Place\\2nd Floor\\nNew York NY 12359\\nUnited States\",\"nationality\":null,\"date_of_birth\":null}}]}}"
},
{
"FieldName": "Source",
"Data": "https://www.realsource.com/data.html"
},
{
"FieldName": "StateProvince",
"Data": "BC"
},
{
"FieldName": "DayOfIncorporation",
"Data": "13"
},
{
"FieldName": "MonthOfIncorporation",
"Data": "05"
},
{
"FieldName": "YearOfIncorporation",
"Data": "1990"
},
{
"FieldName": "BuildingNumber",
"Data": "123"
},
{
"FieldName": "UnitNumber",
"Data": "1"
},
{
"FieldName": "StreetName",
"Data": "Main"
},
{
"FieldName": "StreetType",
"Data": "St"
},
{
"FieldName": "BusinessRegistrationNumber",
"Data": "BRN123ABC"
}
],
"Errors": [],
"FieldGroups": []
}
],
"Errors": [],
"Rule": {
"RuleName": "RuleScript BusinessVerify",
"Note": "Script manually created"
}
},
"Errors": []
}
Understanding the Verify Response
The following information will help you understand the response you will receive for a business verification request.
1. TransactionRecordID
This is the unique ID generated by Trulioo to refer to a particular verification request. You can use this in the [Get Transaction Record] (ref:gettransactionrecord) method to review a past transaction, or you can contact Trulioo Support about a verification result.
2 . RecordStatus
RecordStatus indicates the overall match status of the business you provided, based on the results from the underlying datasources and the verification rule configured for you.
- "match" means the business was verified (one or more datasources provided match signals that satisfied the verification rule)
- "nomatch" means the business could not be verified
You can take the RecordStatus value and use that to determine whether or not a business was verified, or you can dig into the specific datasource results and perform field-by-field matching yourself.
3. DatasourceResults
Each business verification response contains an array of DatasourceResult objects for each datasource configured on an account. Each DatasourceResult contains the following:
a) DatasourceName: Name of the configured datasource(s)
b) DatasourceFields subarray: This indicates the match status for each field sent to that datasource. The match statuses could be:
- match - This field exists in the datasource and matches the value you input
- nomatch - This field exists in the datasource, but does not match the value you input
- missing - Either no data was sent in the Verify Request or no information about this field could be found in the datasource
c) AppendedFields Subarray: This contains all the information on the business that the datasource found based on the input provided. While they're not used for match signal purposes (in the DatasourceFields subarray), the data found in this array offers additional insight into the business being verified.
Ex. This could include status, addresses, Ownership information, Directors & Officers etc.
Standardized Fields - The appended fields for business verification results now contain [standardized] (doc:understanding-standardized-fields) responses in several fields across datasources and countries / jurisdictions. This results in more predictable and uniform responses to your business verification requests, making it easier to interpret results across all geographies.
If the data returned from a datasource does not match the Business Name and/or BRN inputted, you can ignore such results. The datasource attempted to locate but returned close matches after being unable to conclusively find the company.
d) Errors: This contains descriptions and codes for any errors returned by a datasource. These are returned on a per-datasource basis and the rest of the transaction will continue with the other datasources
4. Rule
This will capture the verification rule that was used by GlobalGateway to evaluate the business being verified.
Frequently Asked Questions
1. What is a verification rule?
The information returned for the business verification is checked against a configurable compliance ruleset called the verification rule. A business is said to be ‘verified’ when it passes this rule.
For instance, a match would be determined when one data source returns a match signal on (BusinessName AND BusinessRegistrationNumber AND PostalCode), otherwise, it will be a nomatch.
Other examples:
- Business Name + Business Active status: 1 Records Match (BusinessRegistrationNumber AND (BusinessStatus = "Active"))
- 1 Records Match (BusinessName AND (BusinessRegistrationNumber OR DUNSNumber OR TaxIDNumber))
2. What is the difference between a match rule and a verification rule?
- A verification rule outlines what conditions need to be met to classify a business as ‘verified’. A verification rule outlines which data fields across how many datasources need to be ‘matched’ to consider the business as verified.
Ex. Client inputted Business Name & BRN OR Business Name & Address need to match at least 1 datasource for the business to be considered ‘verified’.
- A matching rule outlines what specific requirements and degree of closeness are needed to be met on a data field to be considered a match.
Ex. Matching threshold on name (to account for spelling variances, omitted words like Amazon vs Amazon Inc), clients can require exact match OR specified level of approximate matching.
3. Can I change & create customized verification & matching rules ?
Yes - you can adjust the verification rules to suit your needs.
4. What is RequestReasonCode? Is this a mandatory input?
RequestReasonCode is a mandatory input for Business Verification requests in Germany. This is the reason for which the target business is being verified and it is necessary to send one of the following codes along with the request:6332 Credit Decision
6333 Assessment of credit solvency for intended business connection
6334 Assessment of credit solvency for ongoing business connection
6335 Debt Collection
6336 Commercial Credit Insurance
6337 Insurance Contract
6338 Leasing Agreement
6339 Rental AgreementUse the 'CountrySpecific' object as follows:
"CountrySpecific": {
"title": "CountrySpecific",
"type": "object",
"properties": {
"DE": {
"title": "DE",
"type": "object",
"properties": {
"RequestReasonCode": {
"type": "string",
"description": "RequestReasonCode",
"label": "Request Reason Code"
},