> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parcha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PEP Screening Check

> Verify that a business's key personnel are not politically exposed persons (PEPs)

The PEP screening check response payload contains a detailed analysis of potential matches between a business's key personnel and politically exposed persons (PEPs). The check evaluates whether any individuals associated with the business hold or have held prominent public functions.

## Check ID

`kyc.pep_screening_check_v2`

## Response Structure

```typescript theme={null}
{
  type: "PEPScreeningCheckResult";
  verified_pep_hits: Array<VerifiedHit> | null;
  passed: boolean;
}

type VerifiedHit = {
  full_name: string | null;
  pep_title: string | null;
  pep_type: string | null;
  pep_status: "Active" | "Inactive" | null;
  roles: Array<{
    name: string | null;
    country: string | null;
    start_date: string | null;  // YYYY-MM-DD
    end_date: string | null;    // YYYY-MM-DD
  }> | null;
  profile_review: {
    match_rating: {
      match: "STRONG_MATCH" | "PARTIAL_MATCH" | "WEAK_MATCH" | "NO_MATCH" | "UNKNOWN";
      explanation: string | null;
    } | null;
  } | null;
}
```

## Example Response

```json theme={null}
{
  "type": "PEPScreeningCheckResult",
  "verified_pep_hits": [
    {
      "full_name": "John G. Smith",
      "pep_title": "State Senator",
      "pep_type": "Politician",
      "pep_status": "Active",
      "roles": [
        {
          "name": "Senator",
          "country": "US",
          "start_date": "2020-01-01",
          "end_date": "2024-01-01"
        }
      ],
      "profile_review": {
        "match_rating": {
          "match": "STRONG_MATCH",
          "explanation": "Name, location, and role details match the individual's profile"
        }
      }
    }
  ],
  "passed": false
}
```

## Response Fields

<ResponseField name="type" type="string">
  The type identifier for the response. Will be "PEPScreeningCheckResult".
</ResponseField>

<ResponseField name="verified_pep_hits" type="array | null">
  List of verified PEP matches found during screening.

  <ResponseField name="full_name" type="string | null">
    Full name of the PEP.
  </ResponseField>

  <ResponseField name="pep_title" type="string | null">
    Official title or position of the PEP.
  </ResponseField>

  <ResponseField name="pep_type" type="string | null">
    Category or type of PEP (e.g., Politician, Judge).
  </ResponseField>

  <ResponseField name="pep_status" type="string | null">
    Current status of the PEP role (Active or Inactive).
  </ResponseField>

  <ResponseField name="roles" type="array | null">
    List of positions or roles held by the PEP.

    <ResponseField name="name" type="string | null">
      Name of the role or position.
    </ResponseField>

    <ResponseField name="country" type="string | null">
      Country where the role is/was held.
    </ResponseField>

    <ResponseField name="start_date" type="string | null">
      Start date of the role (YYYY-MM-DD).
    </ResponseField>

    <ResponseField name="end_date" type="string | null">
      End date of the role (YYYY-MM-DD).
    </ResponseField>
  </ResponseField>

  <ResponseField name="profile_review" type="object | null">
    Analysis of the match quality.

    <ResponseField name="match_rating" type="object | null">
      Assessment of the match strength.

      <ResponseField name="match" type="string | null">
        Match rating category (STRONG\_MATCH, PARTIAL\_MATCH, WEAK\_MATCH, NO\_MATCH, UNKNOWN).
      </ResponseField>

      <ResponseField name="explanation" type="string | null">
        Explanation of the match rating.
      </ResponseField>
    </ResponseField>
  </ResponseField>
</ResponseField>

<ResponseField name="passed" type="boolean">
  Indicates whether the business passed the PEP screening. False if strong PEP matches are found.
</ResponseField>

## Key Components

### PEP Categories

The check evaluates different types of politically exposed persons:

1. **Government Officials**:
   * Heads of state
   * Ministers
   * Parliamentarians
   * Senior civil servants

2. **Judicial Officials**:
   * Judges
   * Prosecutors
   * High-ranking court officials

3. **Military Officials**:
   * Senior military officers
   * Defense officials
   * Intelligence leaders

4. **State Enterprise Leaders**:
   * Directors of state companies
   * Senior managers
   * Board members

### Match Analysis

The check evaluates matches based on multiple criteria:

1. **Identity Matching**:
   * Name comparison
   * Date of birth
   * Nationality
   * Location

2. **Role Verification**:
   * Position details
   * Jurisdiction
   * Time period
   * Authority level

3. **Risk Assessment**:
   * Current vs. historical roles
   * Level of authority
   * Geographic risk
   * Associated entities

### Verification Process

The check performs the following verifications:

1. Screens individual names against PEP databases
2. Verifies biographical information
3. Analyzes role and position details
4. Evaluates temporal relevance
5. Assesses relationship strength

### Match Ratings

The check categorizes matches into different levels:

1. **Strong Match**:
   * Multiple matching identifiers
   * Current role confirmation
   * Clear temporal overlap
   * Geographic consistency

2. **Partial Match**:
   * Some matching identifiers
   * Possible role connection
   * Partial temporal overlap
   * Related jurisdiction

3. **Weak Match**:
   * Limited matching data
   * Historical role only
   * Unclear temporal connection
   * Different jurisdiction