Identity Layer

PEP-AI

Coming soon

Dedicated Politically Exposed Person screening with tier classification (Tier 1/2/3), family member and close associate screening, and source-of-wealth assessment. Runs independently of Sanctions-AI for institutions requiring standalone PEP compliance documentation.

This plugin is in development. The API schema below is planned and subject to change. You can design your integration now using this reference.

Endpoint

POST/api/pep/screen

Request parameters

Parameter	Type	Required	Description
`entity_id`	string	Yes	Your internal reference for this individual.
`full_name`	string	Yes	Full legal name to screen.
`jurisdiction`	string	Yes	One of: CA, AE, SA, GB.
`date_of_birth`	string	No	Date of birth YYYY-MM-DD. Reduces false positives.
`nationality`	string	No	ISO 3166-1 alpha-2 country code.
`position`	string	No	Known public position or role, if any.
`include_family`	boolean	No	Screen immediate family members and close associates (default: true).

Response fields

Parameter	Type	Required	Description
`data.is_pep`	boolean	Yes	Whether the individual is a confirmed PEP.
`data.pep_tier`	string	No	PEP tier: 1 (heads of state), 2 (senior officials), or 3 (other public functions).
`data.pep_category`	string	No	Category: political, judicial, military, state_enterprise, or international_org.
`data.family_matches`	array	No	Matched family members or close associates, if include_family is true.
`data.source_of_wealth`	string	No	AI-generated source of wealth assessment based on public data.
`data.risk_level`	string	Yes	low, medium, high, or critical.
`data.requires_human_review`	boolean	Yes	True if MLRO review is required.

cURL

# Coming soon
curl -X POST \
  https://shield.kodexa.systems/api/pep/screen \
  -H "Content-Type: application/json" \
  -d '{...}'

Code examples available when plugin launches