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

A request requires a name, at least one valid dataset, and a threshold. User will be deducted 1 credit for each AML search.

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

## Request fields (application/json):

  - `countryCodes` (array)
    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, required)
    Name of the business to be searched. Example - Google Inc Max 200 characters allowed.

  - `datasets` (array)
    Specifies which datasets will be searched  - Politically Exposed Persons (All)  - Only linked PEPs (PEP by Association)  - Sanctioned (All)  - Only current Sanctions  - Only former Sanctions  - Insolvency  - Adverse Media  - Profile of Interest  - Enforcement  - State Owned Enterprises (All)  - Only current SOE  - Only former SOE

## Response 201 fields (application/json):

  - `id` (string)
    Id of the search

  - `name` (string)
    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. Available values are new, approved, declined, pending, cancelled, referred and closed.

  - `riskRating` (string)
    Risk associated with the search. Available values are notApplicable, veryLow, low, medium, high AND veryHigh.

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

  - `assignedUser` (string)
    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)
    Note associated with the search

  - `scheduleId` (string)
    Schedule Id linked to 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

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

## 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"