KYB Evaluation Guide
Introduction
In order to assist you in running further KYB evaluations on your own via a self-service model, we’ve created a mock KYB evaluation to mimic the process. To run this evaluation, we will be using public government data from the usaspending.gov website, available at the Award Data Archive. The data represents all contract awards between U.S. suppliers and their U.S. government agency clients, and it can be used as a standard data set for testing data match and fill rates across multiple vendors. We currently offer two methods of running KYB evaluations:
- (Non technical users) Upload a CSV Through Console
- Please contact our sales team if you would like access.
- (Technical users) Download the code & and build with the API
- Python3
Download Test File
- Go to our KYB Evaluation repository in Github.
- Download
sample_file.csv
- Open the file to preview.
We’ll run this data through Enigma’s KYB endpoint and get:
- Names
- Websites
- Addresses
- Industries
- High Risk Activities
- Registrations
- Legal entity
- OFAC Watchlist Screens
Enigma KYB's Advantages
Enigma’s best-in-class KYB solution surfaces registration filings resulting in >70% instant approvals on most customer data sets. Click here to view the final output of the batch append job on the Award Data Archive mentioned above.
Legal and DBA inputs
You can submit requests containing legal names and addresses, as well as 'doing business as' (DBA) names, assumed names, aliases, or operating names and addresses. Enigma's KYB endpoint can provide registration details, industries, and numerous other attributes based on either a legal name or a DBA name as input
State-only matching
The KYB endpoint leverages an optimized search algorithm that only needs the Business Name + State input combination. Even in cases where complete addresses for the queried businesses are unavailable, we can still provide a response based on a precise name + state combination.
Further Resources
- KYB and Identity Use Case Guide
- KYB-Specific Attributes and Objects
- KYB Attribute Description Pages:
Create a Console Account
- Create an account on our Console.
- Once signed up, you’ll see a dashboard on the home screen. You may explore the dashboard and site to become familiar with our resources.
- If you are running an API evaluation, this dashboard is where you’ll find your API key. You will need this when running the code to call the API.
- We have prepared an API mock evaluation here below. For the full API documentation, please refer to this section of the documentation.
Console Evaluation
- Contact our sales team to get access to the Console enrichment feature.
- To run a Console evaluation, go to Secure File Exchange in the menu on the left.
- Drag-and-drop the test file downloaded earlier into the window, or click “Select File” to select it from your system’s file manager. Then click “Upload.”
- Once uploaded, you’ll be directed to the “Sent” tab. You’ll find the file there, along with an “Enrich” button next to it. Click the “Enrich” button.
- This takes you to our Enrichment workflow. You will see a success message indicating that the file was successfully processed. Right below it, there’s a file preview to get a quick sense of the data and make sure your file was correctly uploaded to Enigma. When you’re done previewing the file, click “Continue.”
- Select “Start a new job.”
Under Select a use case, choose “KYB Matching.”
- Match. You’ll see blocks for different input fields, such as “Name,” “Address,”, etc. These are the inputs that will run through the KYB endpoint. Under each field, assign the correct column:
- Name = “business_name”
- Street Address 1 = “street_address1”
- Street Address 2 = “street_address2”
- City = “city”
- State = “state”
- Postal Code = “postal_code”
Once the fields are set, click “Continue.”
- Attributes. This is where you select the attributes you want to see in the result file. For this evaluation, click “Select All” to see the entire KYB package. Then continue.
- You’ll see this popup because OFAC was selected. You can change the sensitivity of the OFAC alerts. For this evaluation, use the default threshold 0.8. You can either type this in, or leave it blank (it will default to 0.8) and click “confirm.”
- Review. Give the output file a name of your choice and review your parameters below. Once you’re ready to kick off the job, click “Submit.”
Once the file is finished processing, it’ll say “Finished” under the name and you can download the output.
Console Output
For more information about our KYB attributes, you can find full breakdowns here.
API Evaluation
-
Download the following code and test data from Github.
-
This package contains 2 files:
sample_file.csv
: This is the test asset we’ll be running an evaluation on. Here’s a snapshot of the data.data_test.py
: This is a Python script to run the inputs fromsample_file.csv
through Enigma’s KYB endpoint and generate a results file:unnested_results.csv
.
-
Open
data_test.py
. In line 9, paste your API key. This is the same key from your Console dashboard (see “Create a Console Account” section).-
import requests import json import csv import time import random import pandas as pd BASE_URL = 'https://api.enigma.com/v1/kyb/' API_KEY = '<YOUR_API_KEY>' start_time = time.time()
-
-
If necessary, don’t forget to install dependencies specified in the file (eg, pandas).
-
Run the script. Once this script has successfully run it will produce a CSV file with the endpoint responses in the root directory called
unnested_results.csv
.
Output Results
Results Summary
The test file contains 221 total businesses. Of those:
- 92% match to a business in Enigma's comprehensive SMB data
- 86% have industry data available
- 81% match to a registration
- 1-2% are flagged for either high-risk activities or OFAC
Count | Percentage of total file | |
---|---|---|
Total input rows | 220 | 100% |
Records with an Enigma SMB match | 204 | 92% |
Records with Enigma industry available | 192 | 86% |
Records with registrations data | 185 | 84% |
Records flagged in OFAC screening | 4 | 1.8% |
Records with high-risk activities detected | 3 | 1.4% |
Registrations Coverage
Registrations
Out of 220 businesses, 84% matched to a registration. To determine which input fields were matched, take a look at the following columns:
- data_legal_entities_matched_fields_0.name
- data_legal_entities_matched_fields_0.address.street_address1
- data_legal_entities_matched_fields_0.address.city
- data_legal_entities_matched_fields_0.address.state
- data_legal_entities_matched_fields_0.address.postal_code
You'll find all registration matches used name and state matching. Only ~40% used street address, city, and postal code. This is because of the optimized algorithm discussed earlier. If you don’t have full addresses for the businesses you’re querying, we can still return a response on just name and state.
Non-matches
Which businesses didn't match to a registration, and why?
34 records did not have a registration match. The top reasons are:
- The record is a sole proprietorship. Sole props tend to have less publicly available data.
- The record is not a business with a registration, but a public institution such as a university or state department.
- The record is missing a state input.
- The record is international.
- Enigma only shows data within the US.
Risky Activities & OFAC
OFAC
4 businesses were flagged through OFAC screening at the organization level. Example:
- LMI CONSULTING, LLC
- flagged on name: LMI
- flag type: organization
- watchlist: SDN
Risky Activities
We found high-risk activities for 3 businesses, where we show a risk flag "high" and the type of activity they engage in. Example:
- WEST MARINE, INC.
- risk flag: high
- activity type: Firearms, Weapons and Ammunition
Learn More
For more information on our KYB endpoint, integration, and pricing, please contact our sales team.
Updated about 1 month ago