Versions

This is to search the profile of the business that contains any information in the "political exposed person" database in OkayDB.

Version 2

To search for individual profiles

POST https://okaydbdemo.innov8tif.com/ekyc/api/aml/v2/person

This operation will search for individual profiles using the parameters provided.

Request Body

Name	Type	Description
name*	string	The full name of the individual you are searching for.
threshold*	integer	Minimum score to filter matched profiles. Minimum: 50 Maximum: 100 Default: 85
countries*	string	Searched country. Two-letter country code ISO-3166-2
datasets*	string	Specifies which datasets will be searched: PEP - Politically Exposed Persons PEP-CURRENT - Only current PEPs PEP-FORMER - Only former PEPs PEP-LINKED - Only linked PEPs SAN - Sanctioned SAN-CURRENT - Only current Sanctions SAN-FORMER - Only former Sanctions INS - Insolvency RRE - Reputational Risk Exposure DD - Disqualified Director POI - Profile of Interest REL - Regulatory Enforcement List
countryRequired	boolean	Default: false
dob	string	Example: 1958-06-13
dobMatching	string	This feature allows more fine grain controls for the date of birth matching. The match score is reduced the further the search date of birth is from the profile’s date of birth, and will be excluded completely if the date is beyond the threshold specified. exact – The date of birth must be a perfect match to produce a hit. sameYear – (default) The date of birth needs to be in the same calendar year of the date specified to produce a hit. withinOneYear – The date of birth must be within 1 year of the date specified in order to produce a hit. withinTwoYears – The date of birth must be within 2 years of the date specified in order to produce a hit. withinThreeYears – The date of birth must be within 3 years of the date specified in order to produce a hit. withinFourYears – The date of birth must be within 4 years of the date specified in order to produce a hit. withinFiveYears – The date of birth must be within 5 years of the date specified in order to produce a hit.
gender	string	This will filter the results to either return only Male or Female profiles. Omit this field to search all profiles.
dobRequired	boolean	Default: false

200: OK

{
    "status": "success",
    "messageCode": null,
    "message": null,
    "matchCount": 1,
    "matches": [
        {
            "qrCode": "873938",
            "version": 1666582026614,
            "resourceUri": "/individuals/c07699f03ed723eeb12669a681ffe269216929c2623d30ca73e63170af431fd6",
            "resourceId": "c07699f03ed723eeb12669a681ffe269216929c2623d30ca73e63170af431fd6",
            "firstName": "Mohd Najib",
            "middleName": "",
            "lastName": "Abdul Razak",
            "gender": "Male",
            "aliases": [
                {
                    "firstName": "Najib",
                    "middleName": "",
                    "lastName": "Abdul Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Najib",
                    "middleName": "",
                    "lastName": "Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohammad",
                    "middleName": "Najib bin Abdul",
                    "lastName": "Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohammad Najib",
                    "middleName": "bin",
                    "lastName": "Abdul Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohammad",
                    "middleName": "Najib bin",
                    "lastName": "Abdul Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohd Najib",
                    "middleName": null,
                    "lastName": "Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohammad Najib",
                    "middleName": null,
                    "lastName": "Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohd Najib",
                    "middleName": "bin",
                    "lastName": "Abdul Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohd",
                    "middleName": "Najib bin",
                    "lastName": "Abdul Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                },
                {
                    "firstName": "Mohd",
                    "middleName": "Najib bin Abdul",
                    "lastName": "Razak",
                    "type": "Name Spelling Variation",
                    "alias": null
                }
            ],
            ......
}

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}

Version 1 (Deprecated)

POST 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

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": "[phone]",
        "faxNumber": "[phone]",
        "mobileNumber": "",
        "email": "[email protected]",
        "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"
          }
        ],
        ........
        
  }

400: Bad Request

{
    // Response
}

500: Internal Server Error

{
    // Response
}