> For the complete documentation index, see [llms.txt](https://api-old.innov8tif.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-old.innov8tif.com/okaydb/aml/search-person/version1.md).

# Version 1

<mark style="color:green;">`POST`</mark> `https://okaydbdemo.innov8tif.com/ekyc/api/aml/v1/person`

#### Request Body

| Name                 | Type   | Description                                                                                                                                                   |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| apiKey               | string | To be assigned by Innov8tif.                                                                                                                                  |
| Threshold            | string | Minimum score to filter matched profiles.                                                                                                                     |
| PEP                  | string | Return PEP profiles. If not provided, then default value is "false" and matched PEP profiles will not be returned.                                            |
| PreviousSanctions    | string | Return previously sanctioned profiles. if not provided, then default value is "false" and matched profiles will not be returned.                              |
| CurrentSanctions     | string | Return currently sanctioned profiles. If not provided, then default value is "false" and matched profiles will  not be returned.                              |
| LawEnforcement       | string | Return profiles from "Law Enforcement" dataset. If not provided, then default value s "false" and matched profiles will not be returned.                      |
| FinancialRegulator   | string | Return profiles from "Financial regulator" dataset. If not provided, ten default value is "false" and matched profiles will not be returned.                  |
| Insolvency           | string | Return profiles from "Insolvency" dataset. If not provided, then default value is "false" and matched profiles will not be returned.                          |
| DisqualifiedDirector | string | Return profiles from "Disqualified Director" dataset. If not provided, then default value is "false" and matched disqualified directors will not be returned. |
| AdverseMedia         | string | Return profiles from "Adverse Media" dataset. If not provided, then default value is "false" and matched disqualified directors will not be returned.         |
| Forename             | string | Searched forename                                                                                                                                             |
| Middlename           | string | Searched middlename                                                                                                                                           |
| Surname              | string | Searched surname                                                                                                                                              |
| DateOfBirth          | string | Searched date of birth                                                                                                                                        |
| YearOfBirth          | string | Searched year of birth                                                                                                                                        |
| Address              | string | Searched address. This  field should not contain city, county/state/postcode/country name.                                                                    |
| City                 | string | Searched city                                                                                                                                                 |
| County               | string | Searched county                                                                                                                                               |
| Postcode             | string | Searched postcode                                                                                                                                             |
| Country              | string | Searched country                                                                                                                                              |

{% tabs %}
{% tab title="200 " %}

```
{
  "recordsFound": 1,
  "matches": [
    {
      "score": 100,
      "person": {
        "id": 873938,
        "title": {
          "description": "None"
        },
        "alternativeTitle": null,
        "forename": "Mohd Najib",
        "middlename": null,
        "surname": "Abdul Razak",
        "dateOfBirth": "1953-07-23",
        "yearOfBirth": 1953,
        "dateOfDeath": null,
        "yearOfDeath": null,
        "isDeceased": false,
        "gender": "Male",
        "nationality": {
          "nationality": "Malaysian"
        },
        "imageURL": "https://secure.c6-intelligence.com/c6images/ari0201950/iHdkxRN4.png",
        "telephoneNumber": "+60 3-8882 3003",
        "faxNumber": "+60 3-8882 3054",
        "mobileNumber": "",
        "email": "najib@pmo.gov.my",
        "pepLevel": 1,
        "isPEP": true,
        "isSanctionsCurrent": false,
        "isSanctionsPrevious": false,
        "isLawEnforcement": true,
        "isFinancialregulator": false,
        "isDisqualifiedDirector": false,
        "isInsolvent": false,
        "isAdverseMedia": true,
        "addresses": [
          {
            "address1": "Level 12, Centre Block",
            "address2": "Ministry of Finance Complex Precinct 2 Federal Government Administrative Center",
            "address3": "",
            "address4": "",
            "city": "Putrajaya",
            "county": null,
            "postcode": "62592",
            "country": {
              "name": "Malaysia"
            }
          },
          {
            "address1": "Pejabat Perdana Menteri",
            "address2": "Blok Utama Bangunan Perdana Putra Pusat Pentadbiran Kerajaan Persekutuan",
            "address3": "",
            "address4": "",
            "city": "Putrajaya",
            "county": null,
            "postcode": "62502",
            "country": {
              "name": "Malaysia"
            }
          },
          {
            "address1": "No. 11 Langgak Duta Street, Taman Duta",
            "address2": "",
            "address3": "",
            "address4": "",
            "city": "",
            "county": "Kuala Lumpur",
            "postcode": "50480",
            "country": {
              "name": "Malaysia"
            }
          }
        ],
        "aliases": [
          {
            "title": null,
            "alternativeTitle": "Dato",
            "forename": "Najib",
            "middlename": "Tun",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": "Dato",
            "forename": "Mohamed",
            "middlename": "Najib bin Abdul",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": "Dato",
            "forename": "Najib",
            "middlename": "",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Mohamed",
            "middlename": "bin Abdul Razak",
            "surname": "Najib"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Mohd",
            "middlename": "",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Najib Tun",
            "middlename": "",
            "surname": "Abdul Razak"
          },
          {
            "title": null,
            "alternativeTitle": "Y.B. Dato' Sri",
            "forename": "Mohd Najib",
            "middlename": "",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": "Y.B. Dato' Sri",
            "forename": "Mohamad Najib",
            "middlename": "",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Mohd",
            "middlename": "Najib",
            "surname": "Abdul Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Najib",
            "middlename": "",
            "surname": "Abdul Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Mohd",
            "middlename": "Najib Bin Tun Haji Abdul",
            "surname": "Razak"
          },
          {
            "title": null,
            "alternativeTitle": null,
            "forename": "Datuk",
            "middlename": "Seri Najib",
            "surname": "Tun Razak"
          }
        ],
        ........
        
  }
```

{% endtab %}
{% endtabs %}

### Input Example

```
{
    "apiKey":"apikey",
    "Threshold":70,
    "PEP":true,
    "PreviousSanctions":false,
    "CurrentSanctions":false,
    "LawEnforcement":false,
    "FinancialRegulator":false,
    "Insolvency":false,
    "DisqualifiedDirector":false,
    "AdverseMedia":false,
    "Forename":"Najib",
    "Middlename":null,
    "Surname":"Razak",
    "DateOfBirth":"1953-07-23",
    "YearOfBirth":1953 ,
    "Address": null,
    "City":null,
    "County":null,
    "Postcode":null,
    "Country":"Malaysia" 
}

```
