Watchlist Screening in Business Search
Sanctions and watchlist screening is a critical compliance requirement for financial institutions, fintech companies, and businesses handling payments or extending credit. This guide explains how Baselayer performs watchlist checks as part of every Business Search, where to find results in the API response, and how to interpret them for your compliance workflows. For a deeper understanding of sanctions compliance concepts, see the Watchlists, Sanctions & Compliance Screening guide. For standalone sanctions and PEP checks outside of Business Search, see the Watchlists & Sanctions: Standalone Checks guide.How Watchlist Screening Works in Business Search
Baselayer automatically performs watchlist screening as part of every Business Search. No additional configuration is required — screening runs by default when you submit a search. Admins can customize which lists run and how strictly names must match in Account Settings (see Customizing Screening below). Baselayer screens applications against a number of sanction lists. All sanction lists are updated daily.What Gets Checked
When you submit a Business Search, Baselayer runs watchlist checks on:- Business name submitted in the search request
- Alternative business names submitted via the
alternative_namesfield (if provided) - Officer names submitted via the
officer_namesfield (if provided) - Business legal name found in the Baselayer business profile (from Secretary of State records)
- Alternative business names found in the Baselayer business profile (from Secretary of State records)
- All officers identified in the Baselayer business profile (from SoS records and other sources)
Watchlists Scanned
Every Business Search screens against the following official government watchlists:
*Checks against U.S. FinCEN Special Measures List are included under Baselayer OFAC checks.
For a detailed explanation of each list and its compliance implications, see the Watchlists, Sanctions & Compliance Screening guide.
Baselayer summarizes the above individual lists in the below umbrella categories (OFAC, CSL, etc.):
Automatic Checks
Five watchlists run automatically with every Business Search: OFAC, CSL, CNS, FBI, and OIG. No additional configuration or input is required. These are the defaults: an admin can turn any of these lists, or PEP, off in Account Settings.Conditional Checks
Two watchlist checks require specific conditions: IEO (IRS Exempt Organizations) — Only runs when atin is provided in the search request. If you need IEO screening, include the business’s TIN in your search.
PEP (Politically Exposed Persons) — Only runs when Order.Pep is included in the search options:
Order.Pep in your search options.
BFC (Baselayer Fraud Consortium) — Returned only to organizations with an active consortium membership, a contractual data-sharing arrangement — it is not an API order option. BFC also behaves differently from every other list: it is never emitted as a count: 0 placeholder. If your organization is not a member, the BFC entry is entirely absent from watchlist_hits — a zero-count row would falsely assert the business had been screened against the consortium, so absence means “not screened”, not “clean”. BFC hits never appear in sandbox under any configuration. See The Baselayer Fraud Consortium to learn about membership.
Understanding the Response
When Baselayer returns a Business Search response, watchlist results appear in two separate locations. Understanding this structure is essential for correctly identifying all potential matches.1. Top-Level watchlist_hits (Search-Level)
The top-level watchlist_hits array contains matches for the data you submitted in your search request: the business name, alternative names, and officer names you provided.
2. Business-Level watchlist_hits (Profile-Level)
The watchlist_hits array nested inside the business object contains matches for data found in Baselayer’s business profile: the business’s legal name, alternative names from Secretary of State records, and officers identified from SoS records and other sources.
Why Two Locations?
The two arrays answer different questions and contain different data:- Search-level (
watchlist_hits): what this search screened: the business name,alternative_names, andofficer_namesyou submitted, evaluated at the moment the search ran (point-in-time). IEO results appear here and on the business. - Business-level (
business.watchlist_hits) — what Baselayer knows about the business entity: the resolved legal name, alternative names, and officers from Secretary of State records. This view is cumulative across searches of the same business, and it is also where Death Master File (DMF) results appear.
count > 0, that’s a compliance flag. A count of 0 means the name was screened against that list and came back clean. A list your organization has disabled in Account Settings is absent from both arrays rather than shown with a count of 0, because it was not screened.
Important: No Split Between Business Names and Officers
Within eachwatchlist_hits array, matches are not separated by type. Business names, alternative names, and officer names all appear together in the same list. For example, if the business name matches OFAC and one of its officers also matches OFAC, you’ll see both in the same details array with a count of 2.
Visual Representation in the Console
In the Baselayer Console, watchlist results are displayed side-by-side:- Left panel: “Your Search” — shows matches for the data you submitted
- Right panel: “Business Name” — shows matches for the Baselayer business profile

Reading Watchlist Results
Structure of a Watchlist Hit
Each entry in thewatchlist_hits array is an envelope with four fields:
code: The short watchlist identifier (OFAC, PEP, CSL, BFC, etc.)name: Human-readable name of the watchlistcount: Number of matches found (0 means the name was screened against that list and no matches were found)details: Array of individual match objects. The shape of these objects is specific to each list — every list carries different fields, so parsedetailsper list rather than assuming one universal schema.
Example: An OFAC Hit
OFACdetails objects currently carry the following fields:
OFAC Detail Fields
name: The watchlist entry’s listed namealternative_names: Known aliases (list of strings)program: The sanctions program the entry belongs to (e.g.,"SDGT","VENEZUELA"). Note this field is singular (program, a string) for OFAC; only CSL match objects useprograms(plural)title: The listed individual’s title, if anyremarks: The Treasury SDN remarks text — often contains DOB, POB, and other identifying details useful for clearing false positivessource: Which OFAC-scope list the match came from:"SDN","NON_SDN", or"FINCEN_311"(may be null)entity_number: The OFAC entity number, as a string, ornull(FinCEN 311 rows carry no entity number)type:"Individual"or"Entity"addresses: A list of strings. For OFAC it contains zero or one element, because the source publishes a single concatenated address string per entrysource_list_url/source_information_url: Links to the official source list and its documentation
Detail Fields Vary by List — and Can Grow
Treat every key in adetails object as optional-and-growing: write your parser to tolerate missing keys and ignore unknown ones.
- Hits are frozen at screening time. A watchlist hit permanently stores the detail shape that was current when the search ran. OFAC hits recorded before late May 2026 carry an older five-field shape (
name,alternative_names,program,title,remarks) — they will not be backfilled. New searches return the full shape shown above. - Addresses differ by list. PEP, CSL, and OIG
addressesare also lists of strings but can contain multiple elements (and can benullfor CSL and OIG). FBI and CNS match objects have no address field at all. Addresses are always lists of plain strings — never lists of objects.
Identifying Matches
Any watchlist entry wherecount > 0 indicates a positive match requiring review. Even if only one name matches, this is a compliance flag that must be investigated.
The Similarity Threshold
Baselayer uses fuzzy name matching to identify potential watchlist matches. Because names can be spelled differently, abbreviated, or contain typos, exact string matching would miss many legitimate matches.Default Thresholds
For Business Search requests, Baselayer uses the following default similarity thresholds to ensure comprehensive coverage:Customizing Screening in Account Settings
Admins can tune watchlist screening for their organization themselves, from the Settings tab in the Baselayer Console. It’s common to choose stricter thresholds (to reduce false positives) or looser thresholds (to maximize coverage) depending on your risk appetite and regulatory requirements. For each of OFAC, PEP, CSL, FBI, CNS and OIG you can:- Turn the list on or off. A disabled list does not run and is absent from
watchlist_hits. - Set its similarity threshold, from
0.0to1.0. A higher threshold returns fewer, more exact matches.
watchlist_hits). Business-level business.watchlist_hits are shared across every search of the same business and are always screened at the 0.95 default, though a list you have disabled is hidden there too.
Settings take effect on searches run after the change. See Account Settings for the full walkthrough.
Choosing the Right Threshold
The default of 0.95 works well for most organizations, providing comprehensive coverage while keeping false positives manageable. Consider adjusting based on your risk tolerance:- Stricter thresholds (0.95+): Fewer false positives requiring manual review, but may miss legitimate matches with significant name variations
- Looser thresholds (0.6–0.8): Maximum coverage for high-risk use cases, but expect more false positives
Screening Configuration and Compliance Documentation
For auditors, examiners, and compliance teams, Baselayer can provide written confirmation of the screening configuration applied to your account. This documentation typically includes:- Which watchlists are scanned — A full list of all watchlists included in every Business Search, along with their run conditions (automatic vs. conditional)
- Similarity thresholds — The configured match sensitivity for each watchlist
- What names are screened — Confirmation that business names, alternative names, and all identified officers are screened against all applicable watchlists
- Change control — Settings can only be changed by your organization’s admins, and Baselayer keeps a versioned record of every change, so we can confirm which configuration applied at any point in time
Implementation: Checking for Watchlist Hits
Best Practices
Always check both response locations. Don’t just check the top-levelwatchlist_hits — also check the business.watchlist_hits array. A match in either location is a compliance flag.
Treat any count > 0 as a flag. Even a single match requires investigation. Don’t ignore low counts.
Review the details. Don’t stop at the count — examine the details array to understand what matched, which sanctions program it’s tied to, and the associated addresses and alternative names. This context helps you determine if it’s a true match or a false positive.
Consider match type. Matches marked as "type": "Individual" are people, while "type": "Entity" are businesses. This distinction matters for your review process.
Use PEP checks for higher-risk scenarios. If you’re onboarding high-value customers or operating in regulated industries, always include Order.Pep in your search options.
Handle false positives gracefully. Not every match is a true positive. Common false positives include common names, similar business names in different industries, and entities with the same name but different locations. Always investigate before rejecting.
Keep records. Log all watchlist screening results, including timestamp, input data, and match details. Regulators may require proof of screening.
Don’t rely solely on automated screening. Watchlist screening is part of a broader compliance program. Combine it with manual review for positive matches, enhanced due diligence for high-risk matches, and ongoing monitoring via Portfolio Monitoring.
Next Steps
- Customize screening: Choose your lists and thresholds in Account Settings
- Learn the fundamentals: Read Watchlists, Sanctions & Compliance Screening for compliance concepts
- Run standalone checks: See Watchlists & Sanctions: Standalone Checks for independent screening outside of Business Search
- Explore Business Search: See the Business Search: API Quickstart for full API details
- Set up monitoring: Use Portfolio Monitoring to continuously screen your customer base