# 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` |
{% tabs %}
{% tab title="PEP Search using Identity Sample Request" %}
```json
{
"type": "individual",
"query": "+2347037730852",
"isSubjectConsent": "true"
}
```
{% endtab %}
{% tab title="PEP Search using Identity Sample Request" %}
```json
{
"type": "business",
"query": "43549813",
"isSubjectConsent": "true"
}
```
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="PEP Search using Identity Sample Response" %}
```json
{
"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": []
}
```
{% endtab %}
{% tab title="PEP Search using Identity Sample Response" %}
```json
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"status": "not_cleared",
"parentId": null,
"isSubjectConsent": true,
"type": "business",
"sanctions": [
{
"title": [
"BARITREND Limited Liability Company"
],
"entityType": "Organization",
"datasets": [
"ua_nabc_sanctions",
"ua_nsdc_sanctions",
"ext_ua_edr"
],
"country": [
"ua"
],
"name": [
"Товариство з обмеженою відповідальністю \"БАРІТРЕНД\"",
"Общество с ограниченной ответственностью \"БАРИТРЕНД\"",
"BARITREND Limited Liability Company"
],
"address": [
"87515, Украина, Донецкая обл., г. Мариуполь, ул. Митрополитская, дом. 120",
"87515, Ukraine, Donetsk region, Mariupol, str. Mytropolytska, 120",
"87515, Україна, Донецька обл., м. Маріуполь, вул. Митрополитська, буд. 120"
],
"sourceUrl": [
"https://sanctions.nazk.gov.ua/en/sanction-company/4810/"
],
"topics": [
"sanction"
],
"registrationNumber": [
"43549813"
],
"keywords": [
"Інші"
],
"jurisdiction": [
"ua"
],
"ogrnCode": [
"43549813"
],
"sanctions": [
{
"sourceUrl": [
"https://sanctions.nazk.gov.ua/"
],
"reason": [
"Указ Президента України від 06.10.2021 №510/2021",
"Decree of the President of Ukraine from 06.10.2021 №510/2021",
"Указ Президента Украины от 06.10.2021 №510/2021"
],
"authority": [
"National Agency on Corruption Prevention"
],
"country": [
"ua"
]
},
{
"sourceUrl": [
"https://zakon.rada.gov.ua/laws/show/n0067525-21#Text",
"https://zakon.rada.gov.ua/laws/show/510/2021#Text",
"https://sanctions.nsdc.gov.ua/"
],
"country": [
"ua"
],
"listingDate": [
"2021-10-06"
],
"program": [
"510/2021"
],
"endDate": [
"2024-10-06T00:00:00.000Z"
],
"duration": [
"Три роки"
],
"authority": [
"National Security and Defense Council"
],
"status": [
"valid"
],
"startDate": [
"2021-07-30T00:00:00.000Z"
]
}
]
},
{
"title": [
"ELIZION KOMPLEKT Limited Liability Company"
],
"entityType": "Organization",
"datasets": [
"ua_nabc_sanctions",
"ua_nsdc_sanctions"
],
"topics": [
"sanction"
],
"ogrnCode": [
"43549813"
],
"name": [
"Общество с ограниченной ответственностью \"ЭЛИЗИОН КОМПЛЕКТ\"",
"Товариство з обмеженою відповідальністю \"ЕЛІЗІОН КОМПЛЕКТ\"",
"ELIZION KOMPLEKT Limited Liability Company"
],
"sourceUrl": [
"https://sanctions.nazk.gov.ua/en/sanction-company/4808/"
],
"country": [
"ua"
],
"registrationNumber": [
"43549813"
],
"address": [
"87515, Украина, Донецкая обл., г. Мариуполь, ул. Митрополитская, дом. 120",
"87515, Ukraine, Donetsk region, Mariupol, str. Mytropolytska, 120",
"87515, Україна, Донецька обл., м. Маріуполь, вул. Митрополитська, буд. 120"
],
"jurisdiction": [
"ua"
],
"keywords": [
"Інші"
],
"sanctions": [
{
"country": [
"ua"
],
"sourceUrl": [
"https://sanctions.nazk.gov.ua/"
],
"reason": [
"Указ Президента України від 06.10.2021 №510/2021",
"Decree of the President of Ukraine from 06.10.2021 №510/2021",
"Указ Президента Украины от 06.10.2021 №510/2021"
],
"authority": [
"National Agency on Corruption Prevention"
]
},
{
"sourceUrl": [
"https://sanctions.nsdc.gov.ua/",
"https://zakon.rada.gov.ua/laws/show/n0067525-21#Text",
"https://zakon.rada.gov.ua/laws/show/510/2021#Text"
],
"listingDate": [
"2021-10-06"
],
"endDate": [
"2024-10-06T00:00:00.000Z"
],
"startDate": [
"2021-07-30T00:00:00.000Z"
],
"program": [
"510/2021"
],
"country": [
"ua"
],
"status": [
"valid"
],
"authority": [
"National Security and Defense Council"
],
"duration": [
"Три роки"
]
}
]
}
],
"pep": [],
"crime": [],
"debarment": [],
"financial_services": [],
"government": [],
"role": [],
"religion": [],
"military": [],
"frozen_asset": [],
"personOfInterest": [],
"watchLists": [],
"totalEntity": 2,
"categoryCount": {
"sanctions": 2,
"pep": 0,
"crime": 0,
"debarment": 0,
"financial_services": 0,
"government": 0,
"role": 0,
"religion": 0,
"military": 0,
"frozen_asset": 0,
"personOfInterest": 0
},
"queriedWith": "Identity Number",
"query": "43549813",
"businessId": "62c2a4868d319373a6280152",
"requestedAt": "2024-01-24T13:17:21.061Z",
"requestedById": "62c2a4868d3193700828014e",
"createdAt": "2024-01-24T13:17:21.106Z",
"lastModifiedAt": "2024-01-24T13:17:21.106Z",
"_createdAt": "2024-01-24T13:17:2121+00:00",
"_lastModifiedAt": "2024-01-24T13:17:2121+00:00",
"id": "65b10de0ed1bbab6f800f3e6",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "62c2a4868d3193700828014e"
}
},
"links": []
}
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.youverify.co/aml-services-anti-money-laundering/pep-and-sanction-screening/search-using-identity.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.