KYB Tasks & Matched Data

The KYB API response is a JSON object that contains two top-level objects:

• The risk_summary object is composed of task results
• The data object is composed of attributes describing the entities that best match the information provided in the request.

Risk Summary (Task Results)

The risk summary section includes all the information you need to automate the decisioning logic of a business onboarding or review workflow. It is composed of tasks, which are discrete verification steps that are typically conducted in a business onboarding or review process. Tasks help you understand whether the submitted business is valid and meets your KYB requirements, or if additional investigation is needed. Tasks results are the output of these steps. You can incorporate task results into the decisioning logic implemented in your workflows.

Each task compares a value that you provided in your KYB API request to the corresponding value in either the business record in Enigma's data set, or the records of the relevant, authoritative Secretary of State (SoS) itself. This means the response will only include tasks results which are relevant to the data you requested.

Task	Description
Address Verification	Compares all input addresses to the addresses of matching records of any kind
SoS Address Verification	Compares all input addresses specifically to the addresses of matching SoS registrations
Name Verification	Compares all input business names to the names of any matching records of any kind
SoS Name Verification	Compares all input names specifically to the names of matching SoS registrations
Person Verification	Compares all input person names to the officer names listed on matching SoS registrations
SSN Verification	Compares all input SSN and person last name combinations to current IRS records
TIN Verification	Compares input TIN and business name combinations to current IRS records
Domestic Registration	Indicates whether a domestic registration was found for the business
Watchlist	Indicates whether the business appears on any U.S. government sanctions lists

Matched Data

The data object returned in the KYB API response is a structured compilation of attributes describing entities in Enigma’s data model that best match the information provided in the request. The response is structured as lists of:

• registered_entities
  • which can have many registrations
    • which can have many persons
    • which can have many addresses
• brands
  • which can operate in many industries
  • which can operate at many operating locations
    • which is located at an address

Together, these attributes offer a holistic perspective of a business and its relationship to people and places. They are the basis on which tasks verify the information you provide about a business.