AML / PEP Screen

Screen individuals and organisations against PEP, sanctions, and adverse media — same criteria as Merchant: search by National ID or by manual names (first_name + last_name), or by entity_name for organisations. Submit one or more scopes (pep, sanctions, adverse_media) and consent: true. POST returns screening_id with status processing; poll GET /api/v1/check/screen/{screening_id}. Only selected scopes appear in the completed response. Live billing uses Merchant aml_pep_pricing (with_id / without_id × screening package). Match objects never expose upstream vendor names.

Loading sandbox test IDs…

Screen subject

POST/api/v1/check/screen

{{baseUrl}}/api/v1/check/screen

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Body Parameters

Parameter	Type	Description	Required
subject_type	string	individual or organisation (entity / organization also accepted)	required
scopes	array	One or more of pep, sanctions, adverse_media	required
country	string	ISO-2 country filter — e.g. KE	optional
id_number	string	National ID search (Merchant ID path). Resolves identity from cache when present. Use this OR first_name + last_name.	optional
first_name	string	Manual name search — required with last_name when id_number is omitted	optional
last_name	string	Manual name search — required with first_name when id_number is omitted	optional
other_names	string	Middle / other names (manual search)	optional
date_of_birth	string	YYYY-MM-DD (manual search refinement)	optional
gender	string	M or F (manual search refinement)	optional
entity_name	string	Required when subject_type is organisation	optional
consent	boolean	Must be true — confirms data-subject consent to perform this verification	required
customer_number	string	Your internal reference (max 255)	optional

Individual — National ID

Request payload for Individual — National ID:

Sample dataRequest payload

{
  "subject_type": "individual",
  "consent": true,
  "scopes": ["pep", "sanctions", "adverse_media"],
  "country": "KE",
  "id_number": "1028845317"
}

Expected response for Individual — National ID:

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening accepted",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "processing",
    "scopes": ["pep", "sanctions", "adverse_media"],
    "subject_type": "individual",
    "message": "Screening is in progress. Poll GET /api/v1/check/screen/{screening_id}."
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Individual — manual names

Request payload for Individual — manual names:

Sample dataRequest payload

{
  "subject_type": "individual",
  "consent": true,
  "scopes": ["sanctions"],
  "country": "KE",
  "first_name": "Victor",
  "last_name": "Sample"
}

Expected response for Individual — manual names:

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening accepted",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "processing",
    "scopes": ["sanctions"],
    "subject_type": "individual",
    "message": "Screening is in progress. Poll GET /api/v1/check/screen/{screening_id}."
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Organisation — entity name

Request payload for Organisation — entity name:

Sample dataRequest payload

{
  "subject_type": "organisation",
  "consent": true,
  "scopes": ["sanctions", "adverse_media"],
  "entity_name": "Blocked Holdings Ltd",
  "country": "KE"
}

Expected response for Organisation — entity name:

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening accepted",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "processing",
    "scopes": ["sanctions", "adverse_media"],
    "subject_type": "organisation",
    "message": "Screening is in progress. Poll GET /api/v1/check/screen/{screening_id}."
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code (typically mirrors HTTP)
message	string	Human-readable status message
data	object	Payload for the verified resource
request_id	string	UUID for support and audit trails
data.screening_id	string	UUID — fetch results with GET /api/v1/check/screen/{screening_id}
data.status	string	processing on accept
data.scopes	array	Requested scopes
data.subject_type	string	individual or organisation
data.message	string	Poll GET /api/v1/check/screen/{screening_id}

Fetch results

Use the screening_id from POST. Completed payload matches production: summary + only selected scope buckets. Match rows include provider_source / pep_profile / target and never expose a vendor source label.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "Alex Sample",
      "search_mode": "manual",
      "first_name": "Alex",
      "last_name": "Sample",
      "country": "KE"
    },
    "scopes": ["pep", "sanctions", "adverse_media"],
    "summary": {
      "is_pep": true,
      "has_sanctions_hit": true,
      "has_adverse_media": true,
      "pep_level": 3,
      "risk_level": "high",
      "overall_risk_score": 100,
      "disposition": "pending_review"
    },
    "pep": {
      "status": "match",
      "match_count": 1,
      "primary_match": {
        "id": "sample-pep-full-001",
        "score": 2.74,
        "match_type": "pep",
        "risk_level": "very_high",
        "pep_level": 3,
        "first_name": "Alex",
        "last_name": "Sample",
        "other_names": "",
        "date_of_birth": "1980-01-15",
        "gender": "male",
        "nationality": "KE",
        "location": "Nairobi, KE",
        "is_active": true,
        "description": "Sample PEP profile for documentation.",
        "position": "Member of Parliament",
        "position_held": "Member of Parliament",
        "provider_source": {
          "id": "sample_pep_list",
          "name": "sample_pep_list",
          "region": "KE",
          "source_type": "pep"
        },
        "pep_profile": {
          "first_name": "Alex",
          "surname": "Sample",
          "other_names": "",
          "date_of_birth": "1980-01-15",
          "gender": "male",
          "nationality": "KE",
          "place_of_birth": "Nairobi, KE",
          "position_held": "Member of Parliament",
          "is_active_pep": true,
          "description": "Sample PEP profile for documentation.",
          "functions": ["Member of Parliament"],
          "titles": null
        },
        "target": {
          "name": "Alex Sample",
          "first_name": "Alex",
          "second_name": "Sample",
          "group_type": "individual",
          "listing_active": true,
          "nationality": ["KE"],
          "function": ["Member of Parliament"],
          "pep_category": "PEP-2"
        }
      },
      "matches": [
        {
          "id": "sample-pep-full-001",
          "score": 2.74,
          "match_type": "pep",
          "risk_level": "very_high",
          "pep_level": 3,
          "first_name": "Alex",
          "last_name": "Sample",
          "other_names": "",
          "date_of_birth": "1980-01-15",
          "gender": "male",
          "nationality": "KE",
          "location": "Nairobi, KE",
          "is_active": true,
          "description": "Sample PEP profile for documentation.",
          "position": "Member of Parliament",
          "position_held": "Member of Parliament",
          "provider_source": {
            "id": "sample_pep_list",
            "name": "sample_pep_list",
            "region": "KE",
            "source_type": "pep"
          },
          "pep_profile": {
            "first_name": "Alex",
            "surname": "Sample",
            "other_names": "",
            "date_of_birth": "1980-01-15",
            "gender": "male",
            "nationality": "KE",
            "place_of_birth": "Nairobi, KE",
            "position_held": "Member of Parliament",
            "is_active_pep": true,
            "description": "Sample PEP profile for documentation.",
            "functions": ["Member of Parliament"],
            "titles": null
          },
          "target": {
            "name": "Alex Sample",
            "first_name": "Alex",
            "second_name": "Sample",
            "group_type": "individual",
            "listing_active": true,
            "nationality": ["KE"],
            "function": ["Member of Parliament"],
            "pep_category": "PEP-2"
          }
        }
      ],
      "sources": ["sample_pep_list"],
      "details": "Found 1 PEP match(es) in political exposure lists"
    },
    "sanctions": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": "sample-sanctions-full-001",
          "score": 1.76,
          "match_type": "sanctions",
          "risk_level": "very_high",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "KE",
          "location": "",
          "is_active": false,
          "description": "",
          "position": "",
          "position_held": "",
          "provider_source": {
            "id": "SAMPLE_LIST",
            "name": "Sample sanctions list",
            "region": "USA",
            "source_type": "sanctions"
          },
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "",
            "functions": null,
            "titles": null
          },
          "target": {
            "name": "Alex Sample",
            "group_type": "individual",
            "nationality": ["KE"]
          }
        }
      ],
      "sources": ["Sample sanctions list"],
      "details": "Found 1 AML match(es) in sanctions lists"
    },
    "adverse_media": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": null,
          "score": 0.5,
          "match_type": "adverse_media",
          "risk_level": "medium",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "",
          "location": "",
          "is_active": false,
          "description": "Sample news headline about Alex Sample",
          "position": "",
          "position_held": "",
          "provider_source": {},
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "Sample news headline about Alex Sample",
            "functions": null,
            "titles": null
          },
          "target": {
            "title": "Sample news headline about Alex Sample",
            "details": "Demonstration adverse media article for API documentation only.",
            "link": "https://example.com/sample-news",
            "category": "General-Adverse-Media",
            "result_id": "am_sample_full_001"
          }
        }
      ],
      "sources": [],
      "details": "Found 1 adverse media match(es)"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Field	Type	Description
data.screening_id	string	UUID from POST /check/screen
data.status	string	completed \| failed
data.subject	object	type, name, search_mode (id \| manual \| organisation), optional id_number / name fields / country
data.scopes	array	Scopes requested on POST
data.summary	object	risk_level, overall_risk_score, disposition, plus flags for selected scopes only
data.pep	object	status, match_count, primary_match, matches, sources, details — only when pep was requested
data.sanctions	object	Only when sanctions was requested
data.adverse_media	object	Only when adverse_media was requested
data.completed_at	string	ISO-8601 completion time
data.processing_notes	string	Optional completion / failure note

Sample — National ID clear (all scopes)

ID search (id_number 1028845317). All three scopes requested; all return no_match. Disposition auto_clear.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "James Otieno Kamau",
      "search_mode": "id",
      "id_number": "1028845317",
      "first_name": "James",
      "other_names": "Otieno",
      "last_name": "Kamau",
      "country": "KE"
    },
    "scopes": ["pep", "sanctions", "adverse_media"],
    "summary": {
      "is_pep": false,
      "has_sanctions_hit": false,
      "has_adverse_media": false,
      "pep_level": 0,
      "risk_level": "low",
      "overall_risk_score": 0,
      "disposition": "auto_clear"
    },
    "pep": {
      "status": "no_match",
      "match_count": 0,
      "primary_match": null,
      "matches": [],
      "sources": [],
      "details": "No PEP matches found"
    },
    "sanctions": {
      "status": "no_match",
      "match_count": 0,
      "matches": [],
      "sources": [],
      "details": "No sanctions matches found"
    },
    "adverse_media": {
      "status": "no_match",
      "match_count": 0,
      "matches": [],
      "sources": [],
      "details": "No adverse media matches found"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Sample — PEP match (manual names)

Manual names (Amina / Ochieng). scopes: ["pep"] — only the pep bucket is returned.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "Amina Njeri Ochieng",
      "search_mode": "manual",
      "first_name": "Amina",
      "other_names": "Njeri",
      "last_name": "Ochieng",
      "country": "KE"
    },
    "scopes": ["pep"],
    "summary": {
      "is_pep": true,
      "pep_level": 3,
      "risk_level": "high",
      "overall_risk_score": 75,
      "disposition": "pending_review"
    },
    "pep": {
      "status": "match",
      "match_count": 1,
      "primary_match": {
        "id": "sample-pep-001",
        "score": 2.74,
        "match_type": "pep",
        "risk_level": "very_high",
        "pep_level": 3,
        "first_name": "Amina",
        "last_name": "Ochieng",
        "other_names": "Njeri",
        "date_of_birth": "1977-02-27",
        "gender": "female",
        "nationality": "KE",
        "location": "Nairobi, KE",
        "is_active": true,
        "description": "Sample political exposure profile for documentation.",
        "position": "Former Cabinet Secretary",
        "position_held": "Former Cabinet Secretary",
        "provider_source": {
          "id": "sample_pep_list",
          "name": "sample_pep_list",
          "region": "KE",
          "source_type": "pep"
        },
        "pep_profile": {
          "first_name": "Amina",
          "surname": "Ochieng",
          "other_names": "Njeri",
          "date_of_birth": "1977-02-27",
          "gender": "female",
          "nationality": "KE",
          "place_of_birth": "Nairobi, KE",
          "position_held": "Former Cabinet Secretary",
          "is_active_pep": true,
          "description": "Sample political exposure profile for documentation.",
          "functions": ["Former Cabinet Secretary"],
          "titles": null
        },
        "target": {
          "name": "Amina Njeri Ochieng",
          "first_name": "Amina",
          "second_name": "Ochieng",
          "group_type": "individual",
          "listing_active": true,
          "nationality": ["KE"],
          "function": ["Former Cabinet Secretary"],
          "pep_category": "PEP-2"
        }
      },
      "matches": [
        {
          "id": "sample-pep-001",
          "score": 2.74,
          "match_type": "pep",
          "risk_level": "very_high",
          "pep_level": 3,
          "first_name": "Amina",
          "last_name": "Ochieng",
          "other_names": "Njeri",
          "date_of_birth": "1977-02-27",
          "gender": "female",
          "nationality": "KE",
          "location": "Nairobi, KE",
          "is_active": true,
          "description": "Sample political exposure profile for documentation.",
          "position": "Former Cabinet Secretary",
          "position_held": "Former Cabinet Secretary",
          "provider_source": {
            "id": "sample_pep_list",
            "name": "sample_pep_list",
            "region": "KE",
            "source_type": "pep"
          },
          "pep_profile": {
            "first_name": "Amina",
            "surname": "Ochieng",
            "other_names": "Njeri",
            "date_of_birth": "1977-02-27",
            "gender": "female",
            "nationality": "KE",
            "place_of_birth": "Nairobi, KE",
            "position_held": "Former Cabinet Secretary",
            "is_active_pep": true,
            "description": "Sample political exposure profile for documentation.",
            "functions": ["Former Cabinet Secretary"],
            "titles": null
          },
          "target": {
            "name": "Amina Njeri Ochieng",
            "first_name": "Amina",
            "second_name": "Ochieng",
            "group_type": "individual",
            "listing_active": true,
            "nationality": ["KE"],
            "function": ["Former Cabinet Secretary"],
            "pep_category": "PEP-2"
          }
        }
      ],
      "sources": ["sample_pep_list"],
      "details": "Found 1 PEP match(es) in political exposure lists"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Sample — sanctions match (manual names)

Manual names (Victor / Sample). scopes: ["sanctions"] — only the sanctions bucket is returned.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "Victor Sample",
      "search_mode": "manual",
      "first_name": "Victor",
      "last_name": "Sample",
      "country": "KE"
    },
    "scopes": ["sanctions"],
    "summary": {
      "has_sanctions_hit": true,
      "risk_level": "high",
      "overall_risk_score": 80,
      "disposition": "pending_review"
    },
    "sanctions": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": "sample-sanctions-001",
          "score": 1.76,
          "match_type": "sanctions",
          "risk_level": "very_high",
          "pep_level": 0,
          "first_name": "Victor",
          "last_name": "Sample",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "KE",
          "location": "",
          "is_active": false,
          "description": "",
          "position": "",
          "position_held": "",
          "provider_source": {
            "id": "SAMPLE_LIST",
            "name": "Sample sanctions list",
            "region": "KE",
            "source_type": "sanctions"
          },
          "pep_profile": {
            "first_name": "Victor",
            "surname": "Sample",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "KE",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "",
            "functions": null,
            "titles": null
          },
          "target": {
            "name": "Victor Sample",
            "first_name": "Victor Sample",
            "second_name": "Sample",
            "group_type": "individual",
            "nationality": ["KE"]
          }
        }
      ],
      "sources": ["Sample sanctions list"],
      "details": "Found 1 AML match(es) in sanctions lists"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Sample — adverse media match

Manual names (Grace / Headline). scopes: ["adverse_media"] — only the adverse_media bucket is returned.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "Grace Headline",
      "search_mode": "manual",
      "first_name": "Grace",
      "last_name": "Headline",
      "country": "KE"
    },
    "scopes": ["adverse_media"],
    "summary": {
      "has_adverse_media": true,
      "risk_level": "medium",
      "overall_risk_score": 55,
      "disposition": "pending_review"
    },
    "adverse_media": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": null,
          "score": 0.5,
          "match_type": "adverse_media",
          "risk_level": "medium",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "",
          "location": "",
          "is_active": false,
          "description": "Sample adverse media headline for documentation",
          "position": "",
          "position_held": "",
          "provider_source": {},
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "Sample adverse media headline for documentation",
            "functions": null,
            "titles": null
          },
          "target": {
            "title": "Sample adverse media headline for documentation",
            "details": "Demo adverse media article used only in API documentation.",
            "link": "https://example.com/sample-adverse-media",
            "category": "General-Adverse-Media",
            "result_id": "am_sample_001"
          }
        }
      ],
      "sources": [],
      "details": "Found 1 adverse media match(es)"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Sample — organisation sanctions

entity_name Blocked Holdings Ltd. scopes: ["sanctions", "adverse_media"] — both buckets returned; only sanctions matches.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "organisation",
      "name": "Blocked Holdings Ltd",
      "search_mode": "organisation",
      "country": "KE"
    },
    "scopes": ["sanctions", "adverse_media"],
    "summary": {
      "has_sanctions_hit": true,
      "has_adverse_media": false,
      "risk_level": "high",
      "overall_risk_score": 80,
      "disposition": "pending_review"
    },
    "sanctions": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": "sample-org-sanctions-001",
          "score": 1.9,
          "match_type": "sanctions",
          "risk_level": "very_high",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "",
          "location": "",
          "is_active": false,
          "description": "",
          "position": "",
          "position_held": "",
          "provider_source": {
            "id": "SAMPLE_UN",
            "name": "Sample consolidated list",
            "region": "INT",
            "source_type": "sanctions"
          },
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "",
            "functions": null,
            "titles": null
          },
          "target": {
            "name": "Blocked Holdings Ltd",
            "group_type": "entity"
          }
        }
      ],
      "sources": ["Sample consolidated list"],
      "details": "Found 1 AML match(es) in sanctions lists"
    },
    "adverse_media": {
      "status": "no_match",
      "match_count": 0,
      "matches": [],
      "sources": [],
      "details": "No adverse media matches found"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Sample — all scopes with hits

Alex / Sample with pep + sanctions + adverse_media. Illustrates the full production match object shape using sample data only.

GET/api/v1/check/screen/{token}

{{baseUrl}}/api/v1/check/screen/{token}

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Screening completed",
  "data": {
    "screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "completed",
    "subject": {
      "type": "individual",
      "name": "Alex Sample",
      "search_mode": "manual",
      "first_name": "Alex",
      "last_name": "Sample",
      "country": "KE"
    },
    "scopes": ["pep", "sanctions", "adverse_media"],
    "summary": {
      "is_pep": true,
      "has_sanctions_hit": true,
      "has_adverse_media": true,
      "pep_level": 3,
      "risk_level": "high",
      "overall_risk_score": 100,
      "disposition": "pending_review"
    },
    "pep": {
      "status": "match",
      "match_count": 1,
      "primary_match": {
        "id": "sample-pep-full-001",
        "score": 2.74,
        "match_type": "pep",
        "risk_level": "very_high",
        "pep_level": 3,
        "first_name": "Alex",
        "last_name": "Sample",
        "other_names": "",
        "date_of_birth": "1980-01-15",
        "gender": "male",
        "nationality": "KE",
        "location": "Nairobi, KE",
        "is_active": true,
        "description": "Sample PEP profile for documentation.",
        "position": "Member of Parliament",
        "position_held": "Member of Parliament",
        "provider_source": {
          "id": "sample_pep_list",
          "name": "sample_pep_list",
          "region": "KE",
          "source_type": "pep"
        },
        "pep_profile": {
          "first_name": "Alex",
          "surname": "Sample",
          "other_names": "",
          "date_of_birth": "1980-01-15",
          "gender": "male",
          "nationality": "KE",
          "place_of_birth": "Nairobi, KE",
          "position_held": "Member of Parliament",
          "is_active_pep": true,
          "description": "Sample PEP profile for documentation.",
          "functions": ["Member of Parliament"],
          "titles": null
        },
        "target": {
          "name": "Alex Sample",
          "first_name": "Alex",
          "second_name": "Sample",
          "group_type": "individual",
          "listing_active": true,
          "nationality": ["KE"],
          "function": ["Member of Parliament"],
          "pep_category": "PEP-2"
        }
      },
      "matches": [
        {
          "id": "sample-pep-full-001",
          "score": 2.74,
          "match_type": "pep",
          "risk_level": "very_high",
          "pep_level": 3,
          "first_name": "Alex",
          "last_name": "Sample",
          "other_names": "",
          "date_of_birth": "1980-01-15",
          "gender": "male",
          "nationality": "KE",
          "location": "Nairobi, KE",
          "is_active": true,
          "description": "Sample PEP profile for documentation.",
          "position": "Member of Parliament",
          "position_held": "Member of Parliament",
          "provider_source": {
            "id": "sample_pep_list",
            "name": "sample_pep_list",
            "region": "KE",
            "source_type": "pep"
          },
          "pep_profile": {
            "first_name": "Alex",
            "surname": "Sample",
            "other_names": "",
            "date_of_birth": "1980-01-15",
            "gender": "male",
            "nationality": "KE",
            "place_of_birth": "Nairobi, KE",
            "position_held": "Member of Parliament",
            "is_active_pep": true,
            "description": "Sample PEP profile for documentation.",
            "functions": ["Member of Parliament"],
            "titles": null
          },
          "target": {
            "name": "Alex Sample",
            "first_name": "Alex",
            "second_name": "Sample",
            "group_type": "individual",
            "listing_active": true,
            "nationality": ["KE"],
            "function": ["Member of Parliament"],
            "pep_category": "PEP-2"
          }
        }
      ],
      "sources": ["sample_pep_list"],
      "details": "Found 1 PEP match(es) in political exposure lists"
    },
    "sanctions": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": "sample-sanctions-full-001",
          "score": 1.76,
          "match_type": "sanctions",
          "risk_level": "very_high",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "KE",
          "location": "",
          "is_active": false,
          "description": "",
          "position": "",
          "position_held": "",
          "provider_source": {
            "id": "SAMPLE_LIST",
            "name": "Sample sanctions list",
            "region": "USA",
            "source_type": "sanctions"
          },
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "",
            "functions": null,
            "titles": null
          },
          "target": {
            "name": "Alex Sample",
            "group_type": "individual",
            "nationality": ["KE"]
          }
        }
      ],
      "sources": ["Sample sanctions list"],
      "details": "Found 1 AML match(es) in sanctions lists"
    },
    "adverse_media": {
      "status": "match",
      "match_count": 1,
      "matches": [
        {
          "id": null,
          "score": 0.5,
          "match_type": "adverse_media",
          "risk_level": "medium",
          "pep_level": 0,
          "first_name": "",
          "last_name": "",
          "other_names": "",
          "date_of_birth": null,
          "gender": null,
          "nationality": "",
          "location": "",
          "is_active": false,
          "description": "Sample news headline about Alex Sample",
          "position": "",
          "position_held": "",
          "provider_source": {},
          "pep_profile": {
            "first_name": "",
            "surname": "",
            "other_names": "",
            "date_of_birth": null,
            "gender": null,
            "nationality": "",
            "place_of_birth": "",
            "position_held": "",
            "is_active_pep": false,
            "description": "Sample news headline about Alex Sample",
            "functions": null,
            "titles": null
          },
          "target": {
            "title": "Sample news headline about Alex Sample",
            "details": "Demonstration adverse media article for API documentation only.",
            "link": "https://example.com/sample-news",
            "category": "General-Adverse-Media",
            "result_id": "am_sample_full_001"
          }
        }
      ],
      "sources": [],
      "details": "Found 1 adverse media match(es)"
    },
    "completed_at": "2026-09-04T10:00:01Z",
    "processing_notes": "Screening completed"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.