{"uid":"cap_fBCAlYEiUOjN05Cc3CMj5","slug":"pep-screening-politically-exposed-persons-c2f48615","name":"PEP Screening (Politically Exposed Persons)","description":"Screen a person's name for politically exposed person (PEP) status: status no_match, possible_match, confirmed_match or unable_to_determine with confidence, sources and ranked candidates with public offices held, dates, current vs former, country and birth year. Open CC0 Wikidata; not complete PEP coverage. Use when onboarding a customer, director or counterparty and you must check whether the person is a politically exposed person (PEP) before KYC/AML sign-off.","url":"https://pep-screen-production.up.railway.app/v1/pep/screen?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Full name of the person to screen"},"limit":{"type":"integer","description":"Max candidates 1-10 (default 5)"},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 country (citizenship or office), e.g. DE, US, FR"},"birth_year":{"type":"integer","description":"Optional birth year to disambiguate (+/-1 year)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"legal":{"terms":"https://pep-screen-production.up.railway.app/terms","privacy":"https://pep-screen-production.up.railway.app/privacy"},"query":{"name":"Olaf Scholz"},"is_pep":true,"status":"ok","use_when":"Use when onboarding a customer, director or counterparty and you must check whether the person is a politically exposed person (PEP) before KYC/AML sign-off.","candidates":[{"name":"Olaf Scholz","is_pep":true,"parties":["Social Democratic Party of Germany"],"deceased":false,"positions":[{"end":null,"start":"2025-03-25","current":true,"position":"member of the German Bundestag"},{"end":"2025-05-06","start":"2021-12-08","current":false,"position":"Federal Chancellor of Germany"}],"birth_year":1958,"pep_status":"current","description":"German politician (SPD), Chancellor of Germany (2021–2025)","match_score":1,"source_link":"https://www.wikidata.org/wiki/Q61053","wikidata_id":"Q61053","citizenships":["DE"]}],"pep_status":"current","best_match_score":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ws26yrwGdK0as9WBwjmBl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens a person's name against Wikidata to determine if they are a Politically Exposed Person (PEP), returning match status, confidence, and ranked candidates with offices held.","exampleAgentPrompt":"Can you screen 'Olaf Scholz' for PEP status — he's German, born in 1958 — I need to know if he's a politically exposed person before we complete KYC sign-off?","exampleUseCases":[{"title":"Customer onboarding PEP check","prompt":"We're onboarding a new corporate client whose director is named Elena Kovalchuk — she claims to be Ukrainian. Can you screen her name for PEP status, narrowing it to Ukraine, before we proceed with AML sign-off?"},{"title":"Board director due diligence","prompt":"Before we appoint François Hollande to the advisory board, can you check whether he's flagged as a politically exposed person? He's French, born in 1954."},{"title":"Counterparty compliance screening","prompt":"We're about to sign a deal with a company whose beneficial owner is listed as Mohamed bin Salman — can you screen that name for PEP status, country SA, and tell me if he currently holds any public office?"}],"resultDescription":"Returns a JSON object with: overall PEP status (true/false), match status (no_match, possible_match, confirmed_match, unable_to_determine), best match score, and an array of ranked candidate matches. Each candidate includes full name, PEP status, current/former positions with start/end dates, party affiliations, birth year, citizenship, Wikidata ID and source link, and a match score. Also includes legal/terms links and the original query echo.","failureModes":["Name too common or ambiguous — returns possible_match or unable_to_determine with multiple low-confidence candidates","Person not in Wikidata — returns no_match even if they are a PEP (coverage gap)","Name spelling variations cause misses — try alternate transliterations","Birth year or country filter too strict — narrows out the correct match","Rate limiting or upstream Wikidata unavailability — service may return error"],"whenToPreferThis":"Use this endpoint when you need a fast, zero-setup PEP check during customer, director, or counterparty onboarding as part of KYC/AML workflows. It is best for public figures likely to appear in Wikidata (politicians, ministers, heads of state, senior officials). For comprehensive commercial PEP coverage including private/regional lists, prefer a commercial sanctions and PEP data provider. This endpoint is ideal for lightweight compliance pre-screening at $0.02 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:30:23.594Z","isFirstParty":false,"canonicalSlug":"pep-screening-politically-exposed-persons-c2f48615"}