# Performs An AML Search For An Individual And Saves The Results To The Database

A request requires a name, or first name and last name, at least one valid dataset and a threshold. Length of name or combination of first name, middle name and last name must not exceed 200 characters. If user is providing first name, middle name and last name combination, the max characters limit includes the formatted name in this format {lastName} {firstName} {middleName}. User will be deducted 1 credit for each search.

Endpoint: POST /compliance/kyc-protect/searches/individuals
Version: 1.10.9
Security: bearerToken

## Request fields (application/json):

  - `countryCodes` (array,null)
    List of Two-letter country code ISO-3166-2.

  - `threshold` (integer, required)
    Hits with scores below the chosen value will not be shown.  Must be one of 75, 80, 85, 90, 95, or 100

  - `name` (string,null)
    Required if FirstName and LastName are not provided

  - `firstName` (string,null)
    If firstName is provided then lastName must also be provided

  - `middleName` (string,null)
    middleName is optional, valid along with firstName and lastName only

  - `lastName` (string,null)
    If LastName is provided then FirstName must also be provided

  - `dateOfBirth` (string,null)
    Date YYYY-MM-DD or YYYY format. Must be after 1900 and not in the future.

  - `gender` (string,null)
    Define the gender of the individual you are searching for. Available values are male and female.
    Enum: "male", "female"

  - `pepTiers` (array,null)
    When searching the PEP dataset, define what tiers of the PEP profiles should be included in the results. PEP Tier 1 - senior roles  PEP Tier 2 - middle-ranking  PEP Tier 3 - junior officials  If the PEP Dataset is NOT included on the list of searched datasets, then this value is ignored. The PEP Tier filter does not apply to PEP-LINKED Profiles.
    Enum: "pepTier1", "pepTier2", "pepTier3"

  - `datasets` (array,null, required)
    Specifies which datasets will be searched  PEP - Politically Exposed Persons (All) PEP-CURRENT - Only current PEPs PEP-FORMER - Only former PEPs PEP-LINKED - Only linked PEPs (PEP by Association) SAN - Sanctioned (All) SAN-CURRENT - Only current Sanctions  SAN-FORMER - Only former Sanctions INS - Insolvency  AM - Averse Media  POI - Profile of Interest  ENF - Enforcement DD - Disqualified Director

## Response 201 fields (application/json):

  - `id` (string)
    Id of the search

  - `name` (string,null)
    Name provided for the search. Length must not exceed 200 characters

  - `countryCodes` (array)
    Countries provided to the search

  - `threshold` (integer)
    Hits with scores below this value will not be shown.

  - `type` (string)
    Indicates whether search type is individual or business

  - `datasets` (array)
    Provided datasets for the search

  - `status` (string)
    Status of the search

  - `riskRating` (string)
    Risk associated with the search

  - `assignedToUserId` (integer,null)
    Id of the user assigned to the search

  - `assignedUser` (string,null)
    Name of the user assigned to the search

  - `createdById` (integer)
    Id of the user who created the search

  - `createdBy` (string)
    Name of the user who created the search

  - `createdAt` (string)
    Search created date time

  - `modifiedById` (integer)
    Id of the user who modified the search

  - `modifiedBy` (string)
    Name of the user who modified the search

  - `modifiedAt` (string)
    Search modified date time

  - `note` (string,null)
    Note associated with the search

  - `totalHitCount` (integer)
    Total number of hits in the search

  - `truePositiveHitsCount` (integer)
    The number of true-positive hits in the search

  - `falsePositiveHitsCount` (integer)
    The number of false-positive hits in the search

  - `undecidedHitsCount` (integer)
    The number of undecided hits in the search

  - `firstName` (string,null)
    First name provided in the search.
The combination of first name, middle name, and last name must not exceed 200 characters

  - `middleName` (string,null)
    Middle name provided in the search.
The combination of first name, middle name, and last name must not exceed 200 characters

  - `lastName` (string,null)
    Last name provided in the search.
The combination of first name, middle name, and last name must not exceed 200 characters

  - `gender` (string,null)
    Gender provided in the search

  - `dateOfBirth` (string,null)
    DOB provided in the search

  - `pepTiers` (array)
    Pep Tiers provided in the search

  - `scheduleId` (string,null)
    Schedule Id linked to the search

  - `isDobRequired` (boolean,null)
    Indicates whether date of birth is required for the individual search.

## Response 400 fields (application/json):

  - `correlationId` (string)
    A unique ID assigned to this request.

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `message` (string)
    Example: "Access forbidden"

## Response 409 fields (application/json):

  - `correlationId` (string)
    The unique identifier. (A UUID specified by RFC4122).

  - `message` (string)

  - `details` (string)
    Provides further information on why the request was rejected