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
- Go to our KYB Evaluation repository in Github.
- Open the file to preview.
We’ll run this data through Enigma’s KYB endpoint and get:
- High Risk Activities
- Legal entity
- OFAC Watchlist Screens
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.
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
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.
- KYB and Identity Use Case Guide
- KYB-Specific Attributes and Objects
- KYB Attribute Description Pages:
- 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.
- 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.
For more information about our KYB attributes, you can find full breakdowns here.
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 from
sample_file.csvthrough Enigma’s KYB endpoint and generate a results file:
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
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%|
Out of 220 businesses, 84% matched to a registration. To determine which input fields were matched, take a look at the following columns:
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.
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.
4 businesses were flagged through OFAC screening at the organization level. Example:
- LMI CONSULTING, LLC
- flagged on name: LMI
- flag type: organization
- watchlist: SDN
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
For more information on our KYB endpoint, integration, and pricing, please contact our sales team.
Updated about 1 month ago