/v3/screening/pep
identity:read
PEP Screening
Checks whether the individual is a Politically Exposed Person or a family member of a PEP, returning risk classifications to support AML obligations.
Try it
Sandbox returns deterministic mock data, no wallet charge. Checking Live availability…
Request body
Body parameters
| Field | Type | Description |
|---|---|---|
first_namerequired |
string | First name (or full_name). |
last_name |
string | Surname. |
middle_name |
string | Middle name. |
gender |
string | Gender (e.g. Male / Female). |
Example responses
200 · Result
{
"request_id": "req_8f2c1a9b7d3e4f60",
"live": true,
"ok": true,
"response_code": "00",
"status": "VERIFIED",
"found": true,
"soft_error": false,
"async_pending": false,
"reference": "VR-D4ACE26C68A3",
"message": "Verification successful.",
"data": {
"status": "FOUND",
"total_hits": 1,
"hits": [
{
"name": "Babatunde Raymond",
"pep": true,
"score": 0.92
}
]
},
"provider": "Farmsky Verify"
}
400 · Bad request
{
"error": "invalid_request",
"message": "first_name (or full_name) is required"
}
401 · Unauthorized
{
"error": "unauthorized",
"message": "API credentials required. Send Authorization: Bearer <client_id>:<secret>."
}
Runs use your signed-in session. For system-to-system integration, issue a keypair in the
Console and send
Authorization: Bearer <client_id>:<secret> against
https://credit.farmsky.africa (Sandbox https://sandbox.credit.farmsky.africa).