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). 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
Sample response for National ID — all scopes clear:
200 OKSample dataSample 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 (sandbox)."
},
"sanctions": {
"status": "no_match",
"match_count": 0,
"matches": [],
"sources": [],
"details": "No sanctions matches found (sandbox)."
},
"adverse_media": {
"status": "no_match",
"match_count": 0,
"matches": [],
"sources": [],
"details": "No adverse media matches found (sandbox)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Manual names — PEP match
Sample response for Manual names — PEP match:
200 OKSample dataSample 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": 2,
"risk_level": "high",
"overall_risk_score": 75,
"disposition": "pending_review"
},
"pep": {
"status": "match",
"match_count": 1,
"primary_match": {
"name": "Amina Njeri Ochieng",
"pep_level": 2,
"score": 92.5,
"positions": ["Former Cabinet Secretary"],
"country": "KE",
"source": "sandbox_pep_list"
},
"matches": [
{
"name": "Amina Njeri Ochieng",
"pep_level": 2,
"score": 92.5,
"positions": ["Former Cabinet Secretary"],
"country": "KE",
"source": "sandbox_pep_list"
}
],
"sources": ["sandbox_pep_list"],
"details": "Sandbox PEP match (demo data)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Manual names — sanctions match
Sample response for Manual names — sanctions match:
200 OKSample dataSample response
{
"success": true,
"response_code": 200,
"message": "Screening completed",
"data": {
"screening_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "completed",
"subject": {
"type": "individual",
"name": "Victor Sanctioned",
"search_mode": "manual",
"first_name": "Victor",
"last_name": "Sanctioned",
"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": [
{
"name": "Victor Sanctioned",
"list": "OFAC SDN (sandbox)",
"score": 88.0,
"country": "KE"
}
],
"sources": ["sandbox_sanctions"],
"details": "Sandbox sanctions match (demo data)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Manual names — adverse media match
Sample response for Manual names — adverse media match:
200 OKSample dataSample 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": [
{
"title": "Sandbox adverse media article",
"snippet": "Demo adverse media hit for integrator testing.",
"source": "sandbox_news",
"published_at": "2024-06-01",
"url": "https://example.com/sandbox-adverse-media"
}
],
"sources": ["sandbox_news"],
"details": "Sandbox adverse media match (demo data)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}Organisation — sanctions match
Sample response for Organisation — sanctions match:
200 OKSample dataSample 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": [
{
"name": "Blocked Holdings Ltd",
"list": "UN Consolidated (sandbox)",
"score": 88.0,
"country": "KE"
}
],
"sources": ["sandbox_sanctions"],
"details": "Sandbox sanctions match (demo data)."
},
"adverse_media": {
"status": "no_match",
"match_count": 0,
"matches": [],
"sources": [],
"details": "No adverse media matches found (sandbox)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}All scopes — PEP hit
Sample response for All scopes — PEP hit:
200 OKSample dataSample 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": "id",
"id_number": "AMLPEP0001",
"first_name": "Amina",
"other_names": "Njeri",
"last_name": "Ochieng",
"country": "KE"
},
"scopes": ["pep", "sanctions", "adverse_media"],
"summary": {
"is_pep": true,
"has_sanctions_hit": false,
"has_adverse_media": false,
"pep_level": 2,
"risk_level": "high",
"overall_risk_score": 75,
"disposition": "pending_review"
},
"pep": {
"status": "match",
"match_count": 1,
"primary_match": {
"name": "Amina Njeri Ochieng",
"pep_level": 2,
"score": 92.5,
"positions": ["Former Cabinet Secretary"],
"country": "KE",
"source": "sandbox_pep_list"
},
"matches": [
{
"name": "Amina Njeri Ochieng",
"pep_level": 2,
"score": 92.5,
"positions": ["Former Cabinet Secretary"],
"country": "KE",
"source": "sandbox_pep_list"
}
],
"sources": ["sandbox_pep_list"],
"details": "Sandbox PEP match (demo data)."
},
"sanctions": {
"status": "no_match",
"match_count": 0,
"matches": [],
"sources": [],
"details": "No sanctions matches found (sandbox)."
},
"adverse_media": {
"status": "no_match",
"match_count": 0,
"matches": [],
"sources": [],
"details": "No adverse media matches found (sandbox)."
},
"completed_at": "2026-09-03T10:00:01Z"
},
"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.