Search using Identity
This endpoint allows you to search for politically exposed entities using different query types e.g. identity number, phone number or company registration number.
PEP Search using Identity
POST
{{baseurl}}/v2/api/verifications/advanced/identity/aml-checks
Headers
Name
Type
Description
token*
String
API secret token
Request Body
Name
Type
Description
query*
String
Identity number of the the subject to query with
isSubjectConsent*
Boolean
Indicate subject has given consent. Must be true
type*
String
Entity type can be all, individual or business
{
"type": "individual",
"query": "+2347037730852",
"isSubjectConsent": "true"
}
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"status": "review_required",
"parentId": null,
"isSubjectConsent": true,
"type": "individual",
"sanctions": [],
"pep": [
{
"title": [
"MUHAMMED GUDAJI"
],
"entityType": "Person",
"datasets": [
"wd_peps",
"wikidata",
"everypolitician"
],
"gender": [
"male"
],
"position": [
"member of the House of Representatives of Nigeria",
"member of the House of Representatives of Nigeria (2019-)",
"House of Representatives (member, 2015-)"
],
"topics": [
"role.pep"
],
"birthDate": [
"1972-01-01T00:00:00.000Z"
],
"alias": [
"Muhammed Gudaji",
"Muhammad Aliyu Gudaji",
"MUHAMMED KAZAURE GUDAJI",
"Muhammed Kazaure Gudaji",
"Muhammed Gudaji Kazaure"
],
"keywords": [
"National government"
],
"country": [
"ng"
],
"nationality": [
"ng"
],
"notes": [
"Nigerian politician"
],
"name": [
"Muhammed Gudaji",
"MUHAMMED GUDAJI"
],
"phone": [
"+2347037730852"
],
"positionOccupancies": [
{
"post": [
{
"country": [
"ng"
],
"name": [
"member of the House of Representatives of Nigeria"
]
}
],
"status": [
"ended"
],
"startDate": [
"2019-06-11T00:00:00.000Z"
],
"endDate": [
"2023-06-11T00:00:00.000Z"
]
},
{
"post": [
{
"country": [
"ng"
],
"name": [
"member of the House of Representatives of Nigeria"
]
}
],
"status": [
"ended"
],
"endDate": [
"2019-06-09T00:00:00.000Z"
],
"startDate": [
"2015-06-09T00:00:00.000Z"
]
}
]
}
],
"crime": [],
"debarment": [],
"financial_services": [],
"government": [],
"role": [],
"religion": [],
"military": [],
"frozen_asset": [],
"personOfInterest": [],
"totalEntity": 1,
"categoryCount": {
"sanctions": 0,
"pep": 1,
"crime": 0,
"debarment": 0,
"financial_services": 0,
"government": 0,
"role": 0,
"religion": 0,
"military": 0,
"frozen_asset": 0,
"personOfInterest": 0
},
"queriedWith": "Identity Number",
"query": "+2347037730852",
"businessId": "6222a5ed3e7a41c29c031ecc",
"requestedAt": "2023-09-21T07:18:47.482Z",
"requestedById": "6222a5ed3e7a41c29c031ece",
"createdAt": "2023-09-21T07:18:47.572Z",
"lastModifiedAt": "2023-09-21T07:18:47.572Z",
"_createdAt": "2023-09-21T07:18:4747+00:00",
"_lastModifiedAt": "2023-09-21T07:18:4747+00:00",
"id": "650bee57b5646f3c2c54a979",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "6222a5ed3e7a41c29c031ece"
}
},
"links": []
}
Last updated
Was this helpful?