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

PEP Search using Identity Sample Request

{
    "type": "individual",
    "query": "[phone]",
    "isSubjectConsent": "true"
}

PEP Search using Identity Sample Request

{
    "type": "business",
    "query": "43549813",
    "isSubjectConsent": "true"
}

PEP Search using Identity Sample Response

{
    "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": [
                    "[phone]"
                ],
                "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": "[phone]",
        "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": []
}

PEP Search using Identity Sample Response

{
    "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": []
}