Understanding Standardized Fields

There is a lot of variation in how information for businesses is stored in various datasources, countries and jurisdictions due to local norms. As a result, the information received by Trulioo and previously displayed to you could have a lot of variability and unpredictability which made it difficult for API programmers to consume these responses across multiple geographies.

With the launch of Standardized Fields in KYB, you can expect more predictable and uniform responses to your business verification requests, making it easier to interpret results across all countries and jurisdictions as well as build streamlined internal processes on top of.

Once your account configurations are updated to standardized datasource variants, you will be able to view the new responses across normalized API (NAPI) as well as on Customer Portal.

What are Standardized Complex Objects?

The new Standardized Complex Objects are JSON objects which allow for the information received to be stored in a structured format. A Standardized Complex Object will have a defined format in terms of one or more properties and their associated values. These are hierarchical, so properties fall under their parent Standardized Complex Object and can be repeated in case multiple records exist.

Example:

 Complex Object “Super Heroes” defined as
 Properties - 
      {
           Name : “String”,
           Age : Number,
           Secret Identity : “Name”,
      }

Example Response

"Super Heroes":
[
   {
      "Name":"Superman",
      "Age":35,
      "Secret Identity":"Clark Kent"
   },
   {
      "Name":"Spiderman",
      "Age":20,
      "Secret Identity":"Peter Parker"
   }
]

The details of the new standardized Complex Objects are outlined below. Please note, not all the properties mentioned below will be returned in every verification, this will depend on the configured country and underlying datasource.

Standardized Registration Numbers

PropertyNotes
RegistrationNumber
RegistrationNumberTypeDescribes what kind of Registration Number it is - it could be Business Registration Number or Tax ID Number. In some countries, there are multiple numbers to identify a company.

Example Response

[
  {
   "Number":"0000123456",
   "Type":"USA SEC CIK NUMBER"
},
{
   "Number":"C45678",
   "Type":"USA FL DOCUMENT NO"
},
{
   "Number":"975864",
   "Type":"USA FEI NUMBER"
}
]

Standardized Business Names

PropertyNotes
NameThe actual name value. Eg. “John’s Doughnuts” or “1825 BC Ltd”
TypeThe ‘type’ of Entity Name. Possible values are:
- Input Business Name
- Input Tradestyle Name
- Returned Business Name
- Returned Alternate Name
- Translated Input Name
- Transliterated Input Name
- Translated Returned Name
- Transliterated Returned Name
- Returned Previous Name
UsedForMatchingA boolean field to indicate the name pairing that was used if there was a ‘match’ set on business name.

Example Response

{
"StandardizedBusinessName":
[
 {
  "Name":"Footy FC",
  "Type":"Returned Business Name",
  "UsedForMatching":true
 },
 {
  "Name":"FOOTYFCINSPANISH",
  "Type":"Input Business Name",
  "UsedForMatching":false
MATCH
 },
{
  "Name":"Footy FC",
  "Type":"Translated Input Name",
  "UsedForMatching":true
 },
{
  "Name":"Juve FC",
  "Type":"Returned Alternate Name",
  "UsedForMatching":false
 },
{
  "Name":"OlderName",
  "Type":"Returned Previous Name",
  "UsedForMatching":false
}
 ]
  }

Standardized Locations

PropertyNotes
LocationTypeCould be Primary, Registered, Mailing, Operational addresses
Address1
BuildingName
BuildingNumber
UnitNumber
StreetName
StreetType
City
PostalCode
StateProvinceCode
CountryCode
POBox

Example Response

[
  {
   "LocationType":"registered",
   "Address1":"1 SW Bow Street, Portland, OR 97005-6453",
   "BuildingNumber":"1",
   "StreetName":"SW Bow Street",
   "StreetType":"Drive",
   "City":"Portland",
   "StateProvinceCode":"OR",
   "PostalCode":"97005-6453",
   "CountryCode":"US"
},
{
   "LocationType":"mailing",
   "Address1":"1 SW Bow Street, Portland, OR 97005-6453",
   "BuildingNumber":"1",
   "StreetName":"SW Bow Street",
   "StreetType":"Drive",
   "City":"Portland",
   "StateProvinceCode":"OR",
   "PostalCode":"97005-6453",
   "CountryCode":"US"
}
]

Standardized Communication

PropertyNotes
CommunicationValuePhone number, email, or website
CommunicationTypeDescription of above

Example Response

[
  {
   "Value":"512346",
   "Type":"Telephone"
},
{
   "Value":"91827364",
   "Type":"Telephone"
},
{
   "Value":"[email protected]",
   "Type":"email"
}
  ]

Standardized Industries

PropertyNotes
IndustryCode
IndustryDescriptionLiteral description of the industry code
IndustryCodeTypeCode system name, for example, North American Industry Classification System (NAICS)

Example Response

[
  {
   "Code":"325510",
   "CodeType":"Unknown",
   "Description":"Paint and Coating Manufacturing"
},
{
   "Code":"327110",
   "CodeType":"NAICS",
   "Description":"Pottery, Ceramics, and Plumbing Fixture Manufacturing”
}
  ]

Standardized Incorporation Details

PropertyNotes
JurisdicitionofIncorporationJurisdiction where the business is incorporated
HomeJurisdictionThe original jurisdiction of incorporation
BusinessLegalFormType of corporate structure the business was incorporated using (standardized value)
OriginalBusinessLegalFormType of corporate structure the business was incorporated using (original value)
DayofIncorporationDate of Incorporation - day
MonthofIncorporationDate of Incorporation - month
YearofIncorporationDate of Incorporation - year
DerivedBusinessAgeInMonthsAge of the business (in months) based on Date of Incorporation & current date

Example Response

{
"StandardizedIncorporationDetails":
[
 {
  "JurisdicitionofIncorporation":"BC",
  "HomeJurisdicition":"AB",
  "BusinessLegalForm":"Non-profit Organization",
  "OriginalBusinessLegalForm":"Society",
  "DayofIncorporation":"17",
  "MonthofIncorporation":"6",
  "YearofIncorporation":"2019",
  "DerivedBusinessAgeInMonths":"52.3",
 }
 ]
  }

Standardized Share Capital

PropertyNotes
CapitalAmountThe amount of the capital in the specified currency
CapitalTypeThe type of capital in question
CurrencyCurrency type (ex. USD, CNY, INR etc.)

Example Response

[
{
   "CapitalAmount":"10500",
   "CapitalType":"Paid up",
   "Currency":"USD"
},
{
   "CapitalAmount":"20000",
   "CapitalType":"Unknown",
   "Currency":"INR”
}
]

Standardized Stock Exchanges

PropertyNotes
TickerNameThe ticker symbol of the company, may include the stock exchange name where available
TickerExchange
TickerCountryCountry of the stock exchange

Example Response

[
  {
   "TickerName":"XYZ",
   "TickerExchange":"NASDAQ",
   "TickerCountry":"US"
},
{
   "TickerName":"XYZA",
   "TickerExchange":"TSX",
   "TickerCountry":"CANADA"
} 
]

Standardized Directors Officers

PropertyNotes
GivenNameThis could be First + Middle Name
Surname
FullName
NationalIDNumber
DateOfBirth
FullAddress
Position
Designation
TypeThis could be Partner or Agent, (anything other than Shareholders and Beneficial Owners)
StatusActive, Resigned
BeginDate
EndDate

Example Response

[
  {
   "FullName":"Steve M.",
   "FullAddress":[
      "TEN CEDAR DRIVE, PORTLAND OR 97005"
                 ],
   "Type":"Individual",
   "Status":"Active",
   "BeginDate":"Unknown"
},
{
   "FullName":"JOHN O’BRIEN",
   "FullAddress":[
      "1 SW Bow Street, Portland, OR 97005-6453"
                 ], 
	"Position" :"President - Affiliates", 
	"Type":"Individual", 
	"Status": "Active", 
	"BeginDate": "Unknown"
}, 
{
	"FullName": "MARK WILLIAMSON",
	"FullAddress": [
			"1 SW Bow Street, Portland, OR 97005-6453",
      "22 CALGARY AVENUE,SEATTLE,WA"
                 ],
	"Position": "CHIEF OPERATING OFFICER",
	"Type": "Individual",
	"Status": "Active",
	"BeginDate": "Unknown"
	}
]

Standardized Company Ownership Hierarchy

The company ownership objects will be comprised of the following two objects:

Object
Ownerships
Relationships

Ownerships Object Field Mapping

PropertyNotes
UniqueIDGlobal Gateway generated ID
VendorIDID assigned by Vendor
DUNSNumber
NationalIDNumber
FullName
GivenNameThis could be First + Middle Name
Surname
BeneficiaryType
BusinessEntityType
FullAddress
City
StateProvinceCode
PostalCode
CountryCode
Nationality
DateOfBirth
ResidenceCountry
LegalAuthority
LegalForm
IsOutOfBusiness
ControlOwnershipType
ControlOwnershipConfidenceLevel
DegreeOfSeparationThis is a measure of the distance between the company being verified and other entities in its ownership structure
0 for the company being verified, 1 for direct owners, 2 for entities owning direct owners and so on
SharesThis is for datasources that have discrete number of shares held by an entity
DirectOwnershipPercentage
IndirectOwnershipPercentage
BeneficialOwnershipPercentage
InferredDirectOwnershipPercentage
InferredIndirectOwnershipPercentage
InferredBeneficialOwnershipPercentage
OwernshipNotesSome datasources may not return actual percentage and return a string similar to "Owns 75-100% of voting rights" and "Has right to appoint and remove directors"
OwnershipUnavailableReasons

Example Response

[
   {
      "UniqueId":"2",
      "VendorId":"Vihjbkj3JEewLqCcEQ",
      "FullName":"Jill Stan",
      "BeneficiaryType":"Class B Common Stock",
      "BusinessEntityType":"person",
      "FullAddress":[
         "17 Autumn Avenue, BEAVERTON OR 96129"
      ],
      "CountryCode":"USA",
      "DegreeOfSeparation":1,
      "Shares":3164.0
   },
   {
      "UniqueId":"3",
      "VendorId":"rzCYmGHUf42WXmJmd1aA",
      "FullName":"JOHN ROGER A",
      "BeneficiaryType":"Class B Common Stock",
      "BusinessEntityType":"person",
      "FullAddress":[
         "35 NEW STREET, NW, WASHINGTON, DC, 2113"
      ],
      "CountryCode":"USA",
      "DegreeOfSeparation":1,
      "Shares":26963.0
   },
   {
      "UniqueId":"4",
      "VendorId":"G8379wGHTOqka9Ho0Ig",
      "FullName":"TOM BRYAN",
      "BeneficiaryType":"Class B Common Stock",
      "BusinessEntityType":"person",
      "FullAddress":[
         "15 COHO DRIVE, PORTLAND, OR, 90289"
      ],
      "CountryCode":"USA",
      "DegreeOfSeparation":1,
      "Shares":109884.91
   }
]

Ownership Summary Object Field Mapping

Summarized view of the company's ownership

PropertyNotes
Total Ownership CountThe total number of ownership entities identified
Maximum Degree of SeparationThe highest ‘degree of separation’ identified
Organizations CountThe number of ownership entities identified that are organizations / businesses
Individuals CountThe number of ownership entities identified that are people
Unknowns CountThe number of ownership entities identified that we were unable to classify as an Individual or Organization
Total Allocated Ownership PercentageThe sum of all Ownership Percentages from the identified entities

Example Response

"OwnershipSummary":
{
  "TotalOwnershipCount":2,  
  "MaximumDegreeOfSeparation":1,
  "TotalAllocatedOwnershipPercentage":75.0,
  "OrganizationsCount":2,
  "IndividualsCount":0,
  "UnknownsCount":0
}

Relationships Object Field Mapping

For each company, there could be multiple ownership relationships. This Complex Object represents an array of relationships.

PropertyNotes
RelationshipIDGlobalGateway generated
ParentUniqueIDThe is the entity owned by another entity
TargetUniqueIDThis is the entity that owns the Parent ID
RelationshipTypeDescription
SharePercentage
InferredSharePercentage
ControlTypeDescription
ControlClassDescription
ControlStartDate
DirectControlTrue / False
RelationshipNotesSome datasources may not return actual percentage and return a string similar to "Owns 75-100% of voting rights" and "Has right to appoint and remove directors"

Example Response

[
   {
      "RelationshipID":"1",
      "ParentUniqueID":"2267180",
      "TargetUniqueID":"267390",
      "RelationshipTypeDescription":"Unknown",
      "SharePercentage":5.6,
      "ControlTypeDescription":"Owned",
      "ControlClassDescription":"",
      "ControlStartDate":"",
      "RelationshipNotes":""
   },
   {
      "RelationshipID":"1",
      "ParentUniqueID":"2267180",
      "TargetUniqueID":"267390",
      "RelationshipTypeDescription":"Unknown",
      "SharePercentage":0.001,
      "ControlTypeDescription":"Owned",
      "ControlClassDescription":"",
      "ControlStartDate":"",
      "RelationshipNotes":""
   }
]

Standardized Metadata

PropertyNotes
SourcesThis is an array to store names of underlying sources
CompanyProfileLastUpdateComplex JSON object to store segmented Year, Month, Day when the Company profile information was last updated in the underlying source
DirectorsOfficersLastUpdateComplex JSON object to store segmented Year, Month, Day when the Directors & Officers information was last updated in the underlying source
OwnershipLastUpdateComplex JSON object to store segmented Year, Month, Day when the Ownership information was last updated in the underlying source
DataRetrievalDateComplex JSON object to store segmented Year, Month, Day when the company information was retrieved from the underlying source

Example Response

{
   "Sources":[
      "Companies House United Kingdom"
   ],
   "UpdateData":[
      {
         "Type":"CompanyProfileLastUpdate",
         "Date":{
            "Day":"25",
            "Month":"10",
            "Year":"2022"
         }
      },
      {
         "Type":"DirectorsOfficersLastUpdate",
         "Date":{
            "Day":"25",
            "Month":"10",
            "Year":"2022"
         }
      },
     {
         "Type":"OwnershipLastUpdate",
         "Date":{
            "Day":"25",
            "Month":"10",
            "Year":"2022"
         }
      },
      {
         "Type":"DataRetrievalDate",
         "Date":{
            "Day":"25",
            "Month":"10",
            "Year":"2022"
         }
      },
   ]
}

Standardized Filings

Which Countries Are Filings Supported?

  • United States
  • China

What filings are available in each country ?

US

  • Financing Statement Filings
  • Mortgages and Charges
  • Judgements
  • Bankruptcy
  • Insolvency
  • Liquidation
  • Suits
  • Liens
  • Claims
  • Commercial Collection Claims

China

  • Change Records
  • Abnormal Business Records
  • Blacklisted Records

How Do I Access Filings Data in the US and China?

One of the following datasource groups must be configured for US:
Business Insights 480052
Ownership Tree 480052

The following datasource group must be configured for China:
Business Insights 500658

Both the Enhanced Profile and Filings fields must be set to True in order to receive Standardized Filing appended data.

PropertyNotes
FilingCategoryPossible values :
Financing Statement Filings
Mortgages And Charges
Judgements
Bankruptcy
Insolvency
Liquidation
Suits
Liens
Claims
Commercial Collection Claims
Violations (China Only)
Change Record (China Only)
FilingType A specific filing type, for example Tax Lien
FilingDescriptionText description of the filing, usually the reason for the filing
FilingReferenceShould be the unique identifier of the filing
FilingStartDate
FilingEndDate
FilingAmountAmount involved
FilingAmountCurrency
FilingRolePlayersList of participants in the filing
Filing Role Players PropertiesNote
NameName of the party involved
RoleDescriptionRole of the party involved, for example, Lien Holder, Filing Office, or Debtors
Address1
City
StateProvince
PostalCode
Country

Example Response - US

{  
  					" FilingCategory ": " Liens ",
            " FilingType ": " Tax Lien ",
            " FilingReference ": " 003293287 ",
            " FilingStartDate ": " 2014 - 10 - 03 ",
            " FilingEndDate ": " 2015 - 01 - 22 ",
            " FilingAmount ": " 2994 ",
            " FilingAmountCurrency ": " USD ",
            " FilingRolePlayers ": [{
                    " Name ": " NEW YORK COUNTY SUPREME COURT ",
                    " RoleDescription ": " Filing Office ",
                    " Address1 ": " 60 CENTRE STREET ",
                    " City ": " NEW YORK ",
                    " StateProvince ": " NY ",
                    " PostalCode ": " 10007 "
                }, {
                    " Name ": " NYC DEPARTMENT OF FINANCE ",
                    " RoleDescription ": " Lien Holder ",
                    " Address1 ": " "
                }, {
                    " Name ": " APPLE INC ",
                    " RoleDescription ": " Debtors ",
                    " Address1 ": " 1 INFINITE LOOP M / S 1 ",
                    " City ": " CUPERTINO ",
                    " StateProvince ": " CA ",
                    " PostalCode ": " 95014 "
                }
            ]
},

Example Response - China

{
    "Filings": [{
            "FilingCategory": "Change Record",
            "FilingType": "Change Record",
            "FilingDescription": "Change item: 样本数据, Previous value: 样本 数据 *** 样本数据:***, New value: 样本数据 *** 样本数据:***",
            "FilingStartDate": "2016-11-03"
        }, {
            "FilingCategory": "Violations",
            "FilingType": "Abnormal Business Record",
            "FilingDescription": "Violation reason: 样本数据, Resolution: N/A",
            "FilingStartDate": "2016-07-13",
            "FilingEndDate": ""
        }, {
            "FilingCategory": "Violations",
            "FilingType": "Abnormal Business Record",
            "FilingDescription": "Violation reason: 样本数据, Resolution: N/A",
            "FilingStartDate": "2015-07-14",
            "FilingEndDate": ""
        }, {
            "FilingCategory": "Violations",
            "FilingType": "Blacklisted Record",
            "FilingDescription": "Violation reason: 样本数据, Resolution: N/A",
            "FilingStartDate": "2018-07-26",
            "FilingEndDate": "",
            "FilingRolePlayers": [{
                    "Name": "样本数据",
                    "RoleDescription": "Enforcement Department"
                }
            ]
        }, {
            "FilingCategory": "Violations",
            "FilingType": "Blacklisted Record",
            "FilingDescription": "Violation reason: 样本数据, Resolution: N/A",
            "FilingStartDate": "2019-08-09",
            "FilingEndDate": "",
            "FilingRolePlayers": [{
                    "Name": "样本数据",
                    "RoleDescription": "Enforcement Department"
                }
            ]
        }
    ]
}

In order to start using Standardized Fields on KYB, you will have to update your account configuration. Please reach out to your Customer Success Manager or email [email protected].