AML / PEP — Fetch Results
Fetch the screening with the screening_id from POST. Same Merchant criteria: ID number or manual names. The completed payload includes only selected scope buckets (pep / sanctions / adverse_media). Match rows never expose upstream vendor names. This endpoint is not billed.
Loading sandbox test IDs…
Request
GET/api/v1/check/screen/{token}
{{baseUrl}}/api/v1/check/screen/{token}Header
National ID — all scopes clear
Expected response for National ID — all scopes clear:
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"
}Manual names — PEP match
Expected response for Manual names — PEP match:
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"
}Manual names — sanctions match
Expected response for Manual names — sanctions match:
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"
}Manual names — adverse media match
Expected response for Manual names — adverse media match:
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"
}Organisation — sanctions match
Expected response for Organisation — sanctions match:
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"
}All scopes — sample hits
Expected response for All scopes — sample hits:
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"
}Response Fields
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.