KYB API Response
The KYB API response is a JSON object that contains two top-level objects: risk_summary and matched data.
Risk Summary
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 government entity 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 secretary of state 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 Secretary of State registrations |
| Person Verification | Compares all input person names to the officer names listed on matching Secretary of State registrations |
| SSN Verification | Compares all input SSN and person last name combinations to current IRS records |
| TIN Verification | Compares all 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 of the KYB response contains all of the data from Enigma's records that the submitted inputs matched to.
The primary record that the KYB API matches to is a registered entity record.
It also returns any brands and registrations that are linked to those registered entities.
Registered Entities
A registered entity is a legal entity that is registered in a state or jurisdiction. It is the primary record that the KYB API matches to. It has the following attributes:
Registrations
A registration is a record of a businesses' filing with a US Secretary of State. It is linked to a registered entity and contains the following attributes:
- Registration State
- Jurisdiction Type
- Home Jurisdiction State
- Registered Name
- File Number
- Issue Date
- Status
- Sub Status
- Status Detail
- Persons that appear on the registration.
- Addresses that appear on the registration.
Brands
A brand is a name that is used to identify a business. It is linked to a registered entity and has the following attributes: