Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zenoo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Screening Request Fields

Submit an entity for standalone AML screening against PEP, sanctions, adverse media, and watchlist databases. Screening also runs automatically as part of Company Verification and Person Verification flows.

​
Request Example

​
Screen a Person

{
  "name": "John Smith",
  "date_of_birth": "1975-03-20",
  "country": "GB",
  "entity_type": "person",
  "categories": ["pep", "sanctions", "adverse_media", "watchlist"]
}

​
Screen a Company

{
  "name": "Acme Holdings Ltd",
  "country": "GB",
  "entity_type": "company",
  "categories": ["sanctions", "adverse_media"]
}

​
Field Reference

FieldTypeRequiredDescription
namestringYesFull name of the person or legal name of the company
date_of_birthstringNoISO 8601 date (YYYY-MM-DD). Person screening only. Reduces false positives by 80-95% on common names
countrystringNoISO 3166-1 alpha-2 code (e.g., GB). Filters results by jurisdiction
entity_typestringNoperson or company. Defaults to person if omitted
categories[]arrayNoScreening categories to check. Defaults to all categories if omitted

​
Screening Categories

ValueDescriptionTypical Sources
pepPolitically Exposed PersonsGovernment records, parliamentary registers
sanctionsGlobal sanctions listsOFAC SDN, EU, UN, UK HMT
adverse_mediaNegative news and mediaNews databases, financial crime reporting
watchlistLaw enforcement and regulatory watchlistsInterpol, FBI, national fugitive lists
If you omit the categories[] array, Zenoo screens against all four categories.

​
Person vs Company Screening

Person and company screening use different matching algorithms optimized for each entity type.
Person screening matches on name, date of birth, nationality, and aliases. Providing date_of_birth is the single most effective way to reduce false positives. Without it, common names like “John Smith” can match hundreds of records.
Company screening matches on legal name, registration jurisdiction, and known aliases. The date_of_birth field is ignored for company screening. Companies are typically screened against sanctions and adverse_media categories only, since PEP status applies to individuals.

​
When to Use Standalone Screening

Screening runs automatically inside Company Verification and Person Verification flows. Use the standalone screening endpoint for:
  • Ongoing monitoring. Re-screen existing customers on a schedule.
  • Quick pre-checks. Screen a name before starting full verification.
  • Batch screening. Screen multiple entities without running full verification.
  • Custom workflows. Screen entities that are not part of a standard verification flow.