KYB Batch Input File Requirements
To send us a file and receive an enriched output, also known as a batch append evaluation, please follow the input guidelines below.
Prerequisites
- You have spoken with our sales and solutions engineering team and discussed a batch append evaluation.
- You have a set of businesses you would like to send for KYB enrichment.
Introduction
To guide you through a KYB batch append evaluation, we outlined all possible input columns we accept in input files.
Summary
At minimum, we require a business name and state for KYB matching. However, if only business name and state are available, Enigma only matches based on an exact match requirement, i.e. the legal entity name input must match exactly the name in the Enigma data asset. If a full exact legal name is not available, we highly recommend adding more inputs.
The more inputs available, the stronger the match. Here is a summary of all possible inputs we accept for KYB, which we will break down further below.
- 2 business names
- 2 addresses
- 1 person (for registration matching)
- 1 website
- 4 people to screen (for OFAC)
- 1 Taxpayer Identification Number (for TIN Verification)
Business Names
We accept up to 2 business names. For best results, we recommend differentiating between legal name and DBA under the columns:
business_name_legal
business_name_DBA
However, we understand this is not possible in all cases. If you are unsure which names are legal vs DBA, you can still add 2 business names. In this case, please change the column names to:
business_name_0
business_name_1
We will run each business name alongside each address to test all possible combinations for matching.
Addresses
We accept up to 2 addresses, broken down by address component.
1st Address Input
street_address1__0
street_address2__0
city_0
state_0
city_0
postal_code_0
2nd Address Input
street_address1__1
street_address2__1
city_1
state_1
city_1
postal_code_1
Person (registration matching)
We accept one person, first name and last name, for registrations matching. This can be an owner or other officer associated with the business’s registration(s). We accept a maximum of one person name, separated by first and last name, under these columns:
first_name
last_name
Website
We accept one website input under the column:
website
Note: we are not able to match on third-party websites. See examples below.
Websites suitable for matching:
- tacombi.com
- https://www.greycafeny.com/
Third-party websites we cannot match on:
- https://www.etsy.com/shop/77Arts
- Where the business being queried is meant to be 77Arts
- facebook.com/ArtWorksDowntown.SanRafael/
- Where the business being queried is meant to be ArtWorksDowntown
OFAC Screening
Enigma automatically screens all business names, addresses, and person names provided in the inputs above, and all business names and registered agents found in the KYB endpoint response.
Additionally, you can add 4 more people for OFAC screening in each record. For each person, we also accept birthdays and addresses for more precise screening. Please follow this schema for these inputs:
Person 1
persons_to_screen__first_name_0
persons_to_screen__last_name_0
persons_to_screen__dob_0
persons_to_screen__street_address1_0
persons_to_screen__street_address2_0
persons_to_screen__city_0
persons_to_screen__state_0
persons_to_screen__postal_code_0
Person 2
persons_to_screen__first_name_1
persons_to_screen__last_name_1
persons_to_screen__dob_1
persons_to_screen__street_address1_1
persons_to_screen__street_address2_1
persons_to_screen__city_1
persons_to_screen__state_1
persons_to_screen__postal_code_1
… and the same pattern continues for additional names (e.g. persons_to_screen__first_name_*
)
Note, these inputs are strictly for OFAC screening and will not be passed through for registration matching.
TIN Verification
We accept one taxpayer identification number for TIN verification under the column:
tin
The TIN should be entered as a 9-digit number.
[Optional] Current Approval Status
The final column in our template is a label for whether or not this record is currently auto-approved by your current vendor (if applicable).
Please place as a TRUE/FALSE value in the column:
auto_approved_by_current_vendor
TRUE means a current vendor can already auto-approve business
FALSE means a current vendor cannot auto-approve this business
This column is not required for matching, but we’ve found it speeds the decision-making process by instantly revealing the incremental value Enigma’s KYB endpoint brings to auto-verification.
Updated 6 months ago