Coverage, data sources & integrations
An honest map of what this service does and does not do. PROOViD AML is an AML screening + case-management service (via API and a back-office interface). It screens names against public sanctions, PEP and adverse-media sources, classifies and risk-scores matches, and manages the resulting cases. It is not a KYC / document-verification product. Everything below was verified against production.
Public watchlists & sources
Screened on every request, ingested directly from the official source (no aggregator middleman) and refreshed every 24 hours. Live entity counts:
| Source | Category | Status | PEP tier from source | Entities (live) | Official source |
|---|---|---|---|---|---|
| OFAC | Sanctions (US) | Live | n/a — sanctions | 19,119 | treasury.gov/ofac/downloads/sdn.xml |
| EU | Sanctions (EU) | Live | n/a — sanctions | 5,994 | data.europa.eu consolidated list |
| UK | Sanctions (UK) | Live | n/a — sanctions | 5,135 | UK OFSI consolidated list (ConList) |
| UN | Sanctions (UN) | Live | n/a — sanctions | 1,002 | scsanctions.un.org consolidated |
| PEPs | Politically-exposed persons | Live | Derived (office-based) | 109,005 | Wikidata (CC0) — heads of state, PMs, ministers, central bankers, ambassadors, MPs |
| Adverse media | News | Live | n/a — media | prefetched (background sweep) | GDELT (DOC + GKG) — evidence prefetched, never fetched during a screen; a subject with no prefetched evidence returns Unavailable, never a clean pass |
| OpenSanctions | Sanctions + PEP aggregator | Bring your own | Graded (office-derived) | — | Your own OpenSanctions key (see Data providers) |
| Criminal records | Criminal background | Bring your own | n/a — criminal | — | No free public list exists — commercial / registry only (see Data providers) |
Counts shown are the latest production snapshot; refreshed automatically every 24 hours.
How PEP coverage works — and its honest limits. The bundled PEP set is built from
Wikidata (free, CC0) on every 24 hour refresh, in two passes so coverage is both
broad and dependable:
- Guaranteed — current national leaders. Every refresh explicitly re-fetches the
sitting holders of every country’s head-of-state and head-of-government
office (a Wikidata
position heldstatement with no end date). This set is small and fetched deterministically, so current presidents / monarchs / prime ministers are always present and refresh within a day of an election or resignation (as soon as Wikidata records it). - Best-effort — the broad set. Ministers, ambassadors, central-bank governors, legislators and historical office-holders are ingested in bulk from the same source, bounded by what the free public Wikidata endpoint can serve — so this layer is comprehensive but not exhaustive (the deep historical long tail may be partial).
- Family & close associates (RCA) of current leaders. The immediate family — parents, spouses/partners, children, siblings and declared relatives — of every sitting head of state / head of government is ingested from Wikidata where the relationship is recorded, and screened as PEP4 Family-or-associate. So relatives such as Melania / Ivanka Trump or Brigitte Macron resolve to a PEP4 hit wherever Wikidata records the family link — the wider associate/enabler graph remains a commercial feed.
Country-anchored leaders index (deterministic). Beyond the passes above, we anchor leader
capture on the fixed list of the world’s ~200 sovereign countries and follow each country’s own
link to its head-of-state / head-of-government office — so no leader can be missed by a data-structure
quirk, and coverage is self-checking (one row per country). We capture the full term history
(dates in office, current and historical) and keep the source-record link on every row.
Per-office reliability:
Every result links back to its Wikidata source record for independent verification.
| Office | Coverage | How it’s anchored |
|---|---|---|
| Head of state | Country-anchored — every sovereign state targeted | The country’s own direct link to the office, as recorded in the source |
| Head of government | Country-anchored — where a separate office exists | The country’s own direct link to the office, as recorded in the source |
| Central-bank governor | Best-effort — ~125 countries | Role + jurisdiction |
| Finance / foreign minister, speaker | Broad pass only | No reliable per-country link in the public data — covered by the best-effort broad set, not faked here |
What leader data we hold — browse it yourself
You do not have to take the above on trust. The country-anchored leaders index is exposed as two
read-only, transparent endpoints (tenant API key or OIDC bearer, Screening.Read) so you can
go country by country and see exactly what we hold:
- Every head of state and head of government, for the world’s ~200 sovereign countries, one row per person × office × term.
- The dates each person was in office (start and end; open-ended = currently serving), so the year-by-year lineage is reconstructable.
- Optionally each leader’s relatives (immediate family / close associates,
shown as PEP4) via
includeRelatives=true. - A derived pepClass on every row: a national office-holder is PEP1, an international-organization role is PEP3, a relative is PEP4. PEP1 Domestic vs PEP2 Foreign is deliberately not baked in here — it is applied per customer at screen time relative to your own home country.
- Every row links back to its Wikidata source record (person and office) for independent verification — the same honest guarantee/best-effort boundary described above still applies (current leaders guaranteed; the deep historical tail best-effort).
The default view shows roughly the last 25 years of terms to keep it
readable — the full history is retained and returned when you widen the window with
yearFrom/yearTo.
| Endpoint | Returns |
|---|---|
GET /v1/leaders | Paginated JSON, one row per leadership term, with the filters below. |
GET /v1/leaders/export.csv | The same filtered rows as a flat CSV download. |
Full parameter, filter and example-response detail is on the API reference.
How the PEP-tier column is read. PEP tiers (PEP1 Domestic / PEP2 Foreign /
PEP3 International-org / PEP4 Family or associate) are only as granular as the office
metadata the source supplies. Two things to know up front: foreign-vs-domestic is inherently
relative to your own jurisdiction, so no source ships a literal “foreign” flag
— it can only ship the office’s country, and the tier is computed at screen time; and PEP tiering only
applies to PEP sources (sanctions and adverse-media lists carry no tier).
For the bundled Wikidata PEP set (free, CC0) we derive the tier from the office the person holds: the ingest reads each office’s jurisdiction (ISO country) and intergovernmental-organization flag, and at screen time the engine grades it against your tenant’s home country — office in your country → PEP1 Domestic, another country → PEP2 Foreign, an IGO role → PEP3 International-org. A PEP whose office carries no jurisdiction, or a tenant that hasn’t set a home country, falls back to the documented PEP1 Domestic default — a deliberate default, not an inferred fact. (The derived tiers populate as the Wikidata list refreshes with the office-jurisdiction data; set your home country on the risk profile to activate Domestic/Foreign grading.) OpenSanctions (bring-your-own) supplies the same office + family/associate (RCA) metadata for an even richer graded classification, consumed by the same engine.
Screening engine
- Classification: True positive / Potential match / False positive / Unknown.
- Decisioning: Pass / Review / Fail — sanctions & criminal → Fail; PEP & adverse media → Review; per-tenant configurable.
- Matching: fuzzy (trigram + Jaro-Winkler), phonetic (double-metaphone), nicknames, transliteration, exact-match mode; per-tenant / per-request threshold.
- Risk scoring: weighted country / category / criminal factors → 0–100 + Low/Med/High band, per-tenant profile — see Score & decision for exactly how.
- PEP tiering — PEP1 Domestic / PEP2 Foreign / PEP3 International-org / PEP4 Family-or-associate — plus adverse-media categories. Tiers are derived from the office the person holds (bundled Wikidata: jurisdiction ISO + IGO flag, graded against the tenant home country; OpenSanctions BYO adds the wider relationship graph) — see the PEP-tier column above. Un-gradeable PEPs fall back to the documented PEP1 Domestic default.
- Coverage presets — ready-made scope bundles (Comprehensive full-scope default / Balanced PEP1–3 / Sanctions-only / Enhanced PEP) plus Custom, controlling which lists are screened + which PEP levels count + the decision policy. Settable as the tenant global default or per-screen; see the coverage presets below.
- Explainability: per-match risk factors returned on every screen and shown in the case view.
Coverage presets
A coverage preset bundles which lists are screened, which PEP levels count
(PEP1–PEP4), and the decision policy — so an operator sets the whole screening scope in one choice.
Set one as the tenant global default (self-serve /v1/coverage + the console
Settings panel, with a Reset) and/or override it per-screen (the coveragePreset
field / screen-card dropdown). Custom exposes the individual list + PEP-level controls. New
tenants default to Comprehensive — the full scope.
| Preset | Lists | PEP levels | Decisions |
|---|---|---|---|
| Comprehensive default | All (UN/OFAC/EU/UK + PEP + adverse media) | PEP1–PEP4 (incl. family/RCA) | Sanctions → Fail; PEP/media → Review |
| Balanced | All | PEP1–PEP3 (drops distant family/associate) | Sanctions → Fail; PEP/media → Review |
| Sanctions-only | UN/OFAC/EU/UK | — (PEP off) | Sanctions → Fail |
| Enhanced PEP | All | PEP1–PEP4 | Foreign (PEP2) & Family/RCA (PEP4) → Fail; others → Review |
| Custom | Your selection | Your selection | Your warning-type policy |
APIs & integrations
| Capability | Status | Surface |
|---|---|---|
| Single screen + retrieve + re-screen | Live | POST /v1/screenings/check, GET /v1/screenings/{id}, /rescreen |
| Bulk + async batch (CSV / XLSX) | Live | /v1/screenings/bulk, /v1/screenings/batch + playground UI |
| Full-text search over history | Live | GET /v1/screenings/search |
| Ongoing monitoring + alerts | Live | monitor:true, /v1/monitoring/subjects |
| Screening coverage presets | Live | GET/POST /v1/coverage (global default + reset), coveragePreset per screen |
| Case management — API | Live | /v1/cases (list/detail/review/notes/attachments/bulk), CSV + regulator-pack (JSON/PDF/Parquet) |
| Case management — interface | Live | Back-office console at /cases (WCAG 2.1 AA) |
| HMAC-signed webhooks | Live | screening.completed, monitoring.alert |
| Identity | Live | Own OIDC IdP + Keycloak (dual-authority) + tenant API keys |
| List version map | Live | GET /v1/lists/version |
| Quota + rate limiting | Live | per-tenant monthly quota + per-minute limit (429 + Retry-After) |
| GDPR data-subject rights | Live | /v1/privacy/… export / erase / restrict / object / rectify + consent |
| White-label branding + theming | Live | GET /v1/branding (accent/secondary/surface/text/font/radius) |
| TypeScript SDK + MCP server (AI agents) | Not yet published | @proovid/aml-sdk, @proovid/aml-mcp-server — in-repo at 0.1.0, not yet on npm |
| Bring-your-own commercial provider | Bring your own | OpenSanctions / adverse-media / criminal-records via tenant's own key — see Data providers |
PEP coverage by category
Exactly which categories of politically-exposed person we hold, mapped to the FATF PEP
definition. For the same coverage broken out by FATF class 1–4 with an explicit
source + ingest-method per office type (and every honest gap named), see
Source & method by FATF class below. Full = captured deterministically or in full from the
free public source; Broad = comprehensive but the deep tail is
sampled at the ingest cap; Partial = specific named offices, or a
bounded topic-driven / entity-anchored subset whose held count we publish but whose completeness
against the full source universe is not measured (we never claim 100% for these);
Commercial = the exhaustive set is a bring-your-own / commercial feed.
Live per-category holder counts and any open gaps are published openly (no auth) at
GET /v1/pep-coverage — this table lists the office classes and tiers; the
exact numbers are read from that self-audit so they can never silently drift. A Full/Broad
tier means we ingested 100% of what the free source reachably exposes for that office class; it is
not a claim of per-country completeness (a per-country green/amber/red matrix is
the forthcoming per-country coverage programme).
This matrix is self-audited — each refresh re-measures what the free source can supply against what we ingested, so gaps surface automatically.
| PEP category | Status | How it's sourced |
|---|---|---|
| Heads of state (presidents, monarchs) | Full | Country-anchored per country (P1906) plus the office class, incl. P31-instance offices — every sovereign state targeted (per-country completeness is measured by the per-country programme, not yet published). |
| Heads of government (PMs, premiers) | Full | Country-anchored per country (P1313) + office class + P31-instance offices. |
| Parliament speakers / presidents of the house | Full | Speaker class (Q1758037) + P31-instance pass — e.g. the President of the Cypriot House of Representatives. |
| Central-bank governors | Full | Governor class (Q107363151) — bounded, covered in full. |
| Central-bank heads — chair / president-titled (US Fed Chair, ECB President) | Partial | Enumerated as specific offices (all holders of each) — chair/president-titled heads the governor class misses. Only these named offices; central-bank heads elsewhere in the world remain a gap. |
| Government ministers (cabinet) | Broad | Minister class (Q83307) + P31-instance pass. Sitting principal ministers covered; the full historical cabinet tail is sampled. |
| Ambassadors / senior diplomats | Broad | Ambassador class (Q121998) + P31-instance pass. |
| Members of parliament / legislators (national legislatures) | Broad | MP class (Q486839) + P31-instance pass. National legislators; the deep historical/local tail is sampled. |
| Senior military officers (chiefs of defence) | Broad | Chief-of-defence class (Q5097014) via subclass closure + P31-instance — each country's top uniformed officer. The broad commissioned-officer corps remains a gap. |
| Intelligence / security-agency heads (CIA, FBI, DNI, FSB) | Partial | Enumerated as specific agency-director offices (all holders). Only these named agencies; the global intelligence-head universe remains a gap. |
| Sub-national officials (state / provincial governors) | Broad | Governor class (Q132050) via subclass closure + a governor-scoped instance-of-subclass pass — US / Nigerian / Indian / Indonesian etc. state governors. |
| Regional / sub-national legislators (state / provincial legislature members) | Being filled | Subdivision-scoped bulk holder ingest (COV-13): P39 holders of a regional-legislature position (P279* of MP class Q486839) whose jurisdiction is a subdivision of the country, for the sub-national-armed countries — capped, politely paced, tagged pep.category:regional-legislature. Filled where free Wikidata has the data (US state legislators, German Land, …); thin/absent elsewhere (commercial feed). See Class 2 source & method. |
| Local-executive officials (mayors / municipal heads) | Broad | Mayor class (Q30185) + P31-instance pass — municipal heads worldwide; the deep global mayor tail is sampled at the ingest cap. Local councillors / assembly members remain a gap. |
| Senior judiciary — chief justices (supreme / constitutional courts) | Broad | Chief-justice class (Q3188089) via subclass closure + P31-instance — the presiding justice of each supreme/constitutional court. Associate justices and the full bench remain a gap (commercial feed). |
| Political-party officials (leaders & chairpersons) | Partial | Party-leader (Q1553195) and party-chair (Q2746259) classes — major national/regional parties. The full local/historical party tail remains a commercial feed. |
| International-organization officials (UN / IMF / EU…) | Partial | IGO offices ingested where modelled in the free source and graded PEP3, tagged pep.category:igo; the held count is published at /v1/pep-coverage. Partial: we publish what we hold, but completeness against the full IGO universe is not source-measured. |
| Family & close associates (RCA) of current heads of state / government | Partial | Relatives pass on every sitting HoS/HoG, graded PEP4, tagged pep.category:relative; the held count is published at /v1/pep-coverage. Partial: held count published, completeness not source-measured. |
| RCA of ministers / MPs / governors (wider associate graph) | Commercial | Only current-leader families are ingested from the free source; the full associate/enabler graph is a commercial feed (not ingested — carried at zero). |
| State-owned-enterprise executives | Partial | Entity-anchored SOE pass keyed on each state-owned enterprise's officer statements (P169 CEO / P488 chair / P1037 director) — a bounded, Wikidata-reachable subset tagged pep.category:soe-executive; the held count is published at /v1/pep-coverage. Partial: the full SOE-executive universe (deep / private tail) remains a commercial feed. |
| Regional heads of government (state / provincial premiers) | Partial | Entity-anchored regional pass keyed on each first-level administrative division's head of government (P6) — tagged pep.category:regional-executive; the held count is published at /v1/pep-coverage. Distinct from the state/provincial governor row above. Partial: a bounded reachable subset. |
| Local government: councillors, local agency/SOE executives, local-court judges | Commercial | The unbounded local tail — most absent from free sources; national-gazette connectors or a commercial feed is the path. |
Every hit is graded into a tier — PEP1 Domestic / PEP2 Foreign
(a national office, relative to your home country) / PEP3 International-organization /
PEP4 Family-or-associate. The Domestic/Foreign split is applied per customer at screen
time. Coverage is self-audited: each refresh re-measures what the free source can supply
against what we ingested, so gaps surface automatically rather than going unnoticed.
Source & method by FATF class (1–4)
The most honest way to read our PEP coverage: for every office type, in every FATF PEP class, exactly which SOURCE the data comes from and HOW we ingest & keep it fresh — including the places where a class is only partial, gap-filled, or not yet covered. The class grouping (Level 1 High → Level 4 Low) follows the standard FATF-aligned PEP classification. No line says “we cover PEPs” without naming the concrete source and method behind it.
Two different “classes” — don’t conflate them. This section is
organised by the FATF PEP class 1–4 — the seniority / risk band of
the office (Level 1 heads of state → Level 4 local officials). That is a different
axis from our engine’s PEP tier (PEP1 Domestic /
PEP2 Foreign / PEP3 International-org /
PEP4 Family-or-associate), which is computed at screen time relative to your
home country (see the PEP-tier column and
methodology). One row here can carry any engine tier — e.g. a
Class-1 minister is PEP1 or PEP2 depending on whose screen it is.
Source legend.
Wikidata WDQS = the free, CC0 Wikidata Query Service (SPARQL) —
our primary PEP source, holders resolved via P39 “position held”;
Wikipedia gap-fill = the free MediaWiki category harvest that
back-fills a registry cell’s named office;
Commercial / BYO = an OpenSanctions / World-Check-class feed on the
tenant’s own key (see Data providers);
Planned = an honest gap, not yet ingested.
Status: Full (ingested in full / country-anchored),
Broad (comprehensive, deep tail sampled at the ingest cap),
Partial (a bounded, reachable subset — held count published, not
source-measured for completeness), Commercial /
Planned (the exhaustive set needs a BYO feed).
Shared method (applies to every Wikidata WDQS row unless
noted). A daily, self-healing WDQS ingest resolves each office class
(by P279* subclass closure and/or P31-instance), fetches its
P39 holders over a ~50-year living-PEP window, and accumulates
(adds/refreshes, stamps “last seen”, keeps anything a flaky run missed, ages out only after
30 days unseen). Each holder is tagged pep.office:<qid>,
pep.jurisdiction:<iso> and pep.category:<slug>, and every office
class is re-measured against the live source each refresh — surfaced per country at
/v1/pep-coverage/countries and per category at
/v1/pep-coverage. Sanctions (UN / OFAC / EU / UK)
come from the official government feeds above and carry no PEP class.
Two tiers of PEP coverage — and where each stands, honestly. The office set is filled by
two different Wikidata mechanisms, at two different levels of completeness:
- National tier — essentially complete (Class 1). National heads, ministers,
central bankers, apex judges, chiefs of defence and party leaders are captured by the
country-anchored leaders index + the office-class passes, and — for individual countries still short
of green after the bulk pass — a registry-anchored
P39fetch: a git-versioned per-country office registry names the exact office QID and the ingest fetches every holder + full term history for the armed countries. (That is the lever that closes a single-country straggler such as a national foreign minister with holders in Wikidata but none yet ingested.) Per-country status is the green/amber/red matrix at/v1/pep-coverage/countries. - Sub-national tier — being filled (Class 2 regional). State/provincial
governors and legislators cannot be reached by the country-scoped passes — their
applies-to-jurisdiction is a subdivision, not the country. A dedicated
subdivision-scoped bulk holder ingest reaches them: it fetches
P39holders of a regional office (governor classQ132050viaP31-of-subclass; regional-legislature classQ486839viaP279*) whose jurisdiction is a subdivision of the country (P1001→P17). It runs for a curated set of sub-national-armed countries with substantial free regional data (US, Germany, Spain, Brazil, Australia, Canada, …), capped per country and politely paced. This tier is genuinely partial: we fill what free Wikidata actually holds and say so — many countries have thin or no free regional data and stay amber/red rather than being forced green. - Local tier (Class 4). Mayors are covered by the bulk mayor holder ingest
(class
Q30185, sampled at the cap); local assemblies / councillors and local-court judges have no free source and are documented gaps (commercial feed), never implied covered.
/v1/pep-coverage and the per-country matrix are the
authoritative "are we complete?" answer — this page describes the method; those endpoints carry the numbers.
FATF Class 1 · High risk
National government, legislature, military, judiciary, central bank, parties
| Office type | Source | Method / how ingested | Status |
|---|---|---|---|
| Heads of state (presidents, monarchs, ruling royal families) | Wikidata WDQS | Country-anchored per country via P1906, plus office class Q48352 (P279* closure) and P31-instance offices. Current sitting holders re-fetched deterministically every refresh (guaranteed); extended royal family via the relatives pass (PEP4). | Full |
| Heads of government (PMs, premiers) | Wikidata WDQS | Country-anchored via P1313 + class Q2285706 closure + P31-instance (catches “PM of <country>” offices, e.g. India Q192711). | Full |
| Parliament speakers / presidents of the house | Wikidata WDQS | Speaker class Q1758037 closure + P31-instance (e.g. President of the Cypriot House). | Full |
| National cabinet ministers — finance / defence / interior / foreign / justice + other | Wikidata WDQS | Minister class Q83307 (closure + P31-instance). Sitting principal ministers covered; the full historical cabinet tail is sampled at the 250k ingest cap. The five FATF-salient portfolios are a measurement dimension in the per-country registry (CabinetFinance/Defence/Interior/Foreign/Justice), not separate ingest passes. | Broad |
| National legislatures — members of parliament (lower & upper house) | Wikidata WDQS | MP class Q486839 closure + P31-instance legislature seats. Deliberately not the “member of a legislature” superclass (its closure explodes to ~74k municipal/regional/historical seats). National legislators covered; the deep historical / sub-national tail is sampled. | Broad |
| Central-bank governors (boards of central banks) | Wikidata WDQS | Governor class Q107363151 (P279* closure) — bounded (~1k), ingested in full. | Full |
| Central-bank heads titled chair / president (US Fed Chair, ECB President) | Wikidata WDQS | Explicit office QIDs Q2666591 (Fed Chair) / Q605440 (ECB President) — all P39 holders fetched directly, because these chair/president-titled heads fall outside the governor class. | Partial — only these named offices; chair/president-titled central-bank heads elsewhere are a gap. |
| Armed forces — chief of defence / top uniformed officer | Wikidata WDQS | Chief-of-defence class Q5097014 closure + P31-instance — WDQS-measured ~51 offices / ~432 holders, each country’s top uniformed officer. | Broad — the broad commissioned-officer corps remains a gap. |
| Intelligence / security-agency heads (CIA, FBI, DNI, FSB) | Wikidata WDQS | Explicit office QIDs Q27656/Q1057168/Q1154057/Q4399975 — all holders of each, tagged pep.category:intelligence-security. | Partial — these four named agencies; the global intelligence-head universe is a gap. |
| Police / law-enforcement heads (general) | Planned / Commercial | No bundled free office class today. The FBI director is captured as an intelligence head above; general national/regional police chiefs need a named-office (Explicit) addition or a commercial feed. Stated plainly rather than implied. | Planned |
| Fire-service heads | Planned / Commercial | No free Wikidata office class is ingested for fire-service heads — an honest gap; a national-gazette connector or commercial feed is the path. | Planned |
| Senior officials of other state agencies / high-ranking civil servants | Wikidata WDQS + Commercial | Specific high-value agency directors are captured via the Explicit pass; the broad senior-civil-service universe is not bundled and is the commercial-feed path. | Partial (named agencies) → Commercial (tail) |
| Top-ranking political-party officials (leaders & chairs) | Wikidata WDQS | Party-leader class Q1553195 + party-chair Q2746259 (closure + P31-instance, WDQS-measured ~1,697 holders), tagged pep.category:party-official. Front-loaded in the ingest budget so the cap never starves them. | Partial — major national/regional parties; the local/historical party tail is commercial. |
FATF Class 2 · Medium risk
Regional government / parliament / judiciary, IGOs, diplomatic missions
| Office type | Source | Method / how ingested | Status |
|---|---|---|---|
| Regional / sub-national governments — state / provincial governors | Wikidata WDQS | Governor class Q132050 (P279* closure) plus a governor-scoped instance-of-subclass pass (P31 of any P279* subclass of Q132050) — WDQS-measured 196 offices / ~2,976 holders (US / Nigerian / Indian / Indonesian … states), tagged pep.category:sub-national. The per-country regional-executive aggregate cells are additionally filled by the same subdivision-scoped bulk ingest as regional legislators below (governors are P31 of a subclass of Q132050 whose jurisdiction is a subdivision), for the sub-national-armed countries. | Broad |
| Regional heads of government — state / provincial premiers | Wikidata WDQS | Entity-anchored pass keyed on each first-level administrative division’s P6 head-of-government (Q10864048), run outside the bulk cap — WDQS-measured ~1,601 holders, tagged pep.category:regional-executive. Distinct from the governor class (which keys off the office). | Partial — a bounded reachable subset. |
| Regional parliaments / sub-national legislators (state / provincial legislature members) | Wikidata WDQS | Subdivision-scoped bulk holder ingest (COV-13 sub-national tier). Rather than enumerate the ~74k-seat superclass we deliberately exclude, a dedicated pass fetches the P39 holders of any position that is a P279* subclass of member of parliament Q486839 whose applies-to-jurisdiction (P1001) is a subdivision of the country (P1001 → P17 = the country) — so a state/provincial legislature seat is reached, a national one is not. Runs only for the sub-national-armed countries (a curated set with substantial free regional coverage — US state legislators, German Land, Spanish autonomous communities, Brazilian / Australian / Canadian etc.), capped per country and WDQS-politely paced, and tagged pep.office:Q486839 / pep.jurisdiction:<iso> / pep.category:regional-legislature. Per-country fill is published live at /v1/pep-coverage/countries. | Being filled — armed countries only; countries with thin/no free regional data stay a documented gap (commercial feed). |
| Regional / sub-national judiciary | Planned / Commercial | Below the national apex bench (captured in Class 1); regional and local judges are a commercial feed. | Commercial |
| International & supranational organisation officials (UN / IMF / EU …) | Wikidata WDQS | IGO offices modelled in the free source, graded PEP3 International-org and tagged pep.category:igo. Held count published at /v1/pep-coverage. | Partial — held count published; completeness vs the full IGO universe is not source-measured. |
| Diplomatic missions — ambassadors (also consuls / high commissioners) | Wikidata WDQS | Ambassador class Q121998 closure + P31-instance (~6.5k position subclasses). | Broad — ambassadors covered broadly; consuls / lower diplomatic staff are partial. |
FATF Class 3 · Medium risk
State-owned enterprises & regional public-sector institutions
| Office type | Source | Method / how ingested | Status |
|---|---|---|---|
| National state-owned-enterprise executives (senior management & board of directors) | Wikidata WDQS | Entity-anchored SOE pass keyed on each state-owned enterprise’s officer statements — P169 (CEO) / P488 (chair) / P1037 (director) — across 12 state-ownership + archetype anchors (SOE class Q270791, government-owned corporation, owned-by-a-sovereign-state P127, central bank, public broadcaster, sovereign-wealth fund, national oil / rail / airline …). WDQS-measured ~583 execs, tagged pep.category:soe-executive. Generic “CEO” (Q484876, every company head worldwide) is deliberately not used. | Partial — the deep / private SOE-executive tail is commercial. |
| Regional public-sector institutions / regional SOEs / heads of agencies under regional governments | Planned / Commercial | National SOE execs are captured above; heads of agencies / SOEs / institutions specifically under regional governments are not separately bundled — the commercial-feed path. | Commercial |
FATF Class 4 · Low risk
Local government — mayors, assemblies, local bodies, local courts
| Office type | Source | Method / how ingested | Status |
|---|---|---|---|
| Mayors / municipal heads (local-executive) | Wikidata WDQS + gap-fill | Mayor class Q30185 (closure + P31-instance), tagged pep.category:mayor — armed once the rarity-prior screening guard (#112) shipped, since the global mayor set (~57k positions) is the batch’s biggest common-name false-positive surface. The deep global tail is sampled at the ingest cap; named offices (e.g. Mayor of Nicosia Q12878858) are pinned via the Explicit pass; the Wikipedia-category harvest back-fills registry cells. | Broad (sampled / gap-filled) |
| Local / county / city / district assembly members (councillors) | Planned / Commercial | The unbounded local-councillor tail is largely absent from free sources; a national-gazette connector or commercial feed is the path. | Commercial |
| Senior executives of local governmental bodies (local agencies, local SOEs) | Planned / Commercial | Local-body executives beyond mayors are not bundled — commercial feed. | Commercial |
| Judges of local courts | Planned / Commercial | Only national apex chief justices (Q3188089, presiding justice of each supreme / constitutional court) are bundled — see Class 1. Local-court judges are a commercial feed. | Commercial |
Everything marked Wikidata WDQS is free, refreshed
every 24 hours, self-healing, and self-audited — the held counts above can never silently
drift because each refresh re-measures the live source (per country at
/v1/pep-coverage/countries, per category at
/v1/pep-coverage). Where a row is
Planned or Commercial we say so rather
than imply coverage: no fully-free, unlimited, continuously-verified global PEP/RCA source
exists, and the exhaustive tail is wired through a bring-your-own
commercial provider into the same engine. Family & associates (RCA) are a separate axis — see the
PEP coverage by category matrix and how PEP
levels are derived.What's not included (and why)
Being explicit so there are no surprises:
| Item | Status | Why / how to get it |
|---|---|---|
| Criminal-records data feed | BYO | No free public list exists — it's commercial/registry data. Plug in your own feed per tenant. |
| Exhaustive PEP long tail (every historical local MP/councillor) | BYO | We ship the comprehensive Wikidata set (~109k, free/CC0). The full global tail is a bulk/commercial PEP feed. |
| Additional national / specialised sanctions lists (beyond UN/OFAC/EU/UK) | On request | Addable as direct connectors, or via the OpenSanctions BYO aggregator (carries many at once). |
| WorldCheck / Dow Jones connectors | BYO / contract | Commercial; wired through the bring-your-own provider seam when licensed. |
| KYC document verification, liveness, face-match, mobile SDKs | Out of scope | A separate KYC product — this service is AML screening + case management only. |
| Threshold / turnover engine | Out of scope | Belongs to the broader KYC/transaction platform, not the screening engine. |
| DPIA / ROPA, penetration test, pilot sign-off, SLO/WAF | Owner / process | Compliance & operations track, owned by the customer/operator. |
Bottom line: the public sanctions (UN / OFAC / EU / UK),
PEP and adverse-media sources requested are all live and refreshed
every 24 hours, and case management is available via both the API and the interface.
The only screening category without a bundled public feed is criminal records (no
free source exists), available as a bring-your-own provider.
© PROOViD AML · Developer Docs
Source & method by class · How the data is built · Score & decision · Data providers · API reference