# 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 %}