# Start review of an AML check

Starts the manual review process for an AML check with a specified ID.

This operation also sets the AML check reviewStartTime to the current date-time,
and updates the review information.

Endpoint: POST /aml-checks/{id}/start-review
Version: latest
Security: SecretApiKey, JWT

## Path parameters:

  - `id` (string, required)
    ID of the resource.

## Response 201 fields (application/json):

  - `id` (string)
    Unique resource ID.
    Example: "aml_chk_0YV8XJT2ZWDR398Q8NFEM7DEPM"

  - `createdTime` (string)
    Date and time when the resource is created.
This value is set automatically when the resource is created.

  - `updatedTime` (string)
    Date and time when the resource is updated.
This value is set automatically when the resource is updated.

  - `websiteId` (string)
    Website ID associated with the customer.
    Example: "web_0YV7DE4Z26DQSA1AC92FBJ7SEG"

  - `reviewerId` (string,null)
    User ID of the person who reviewed the AML check.
    Example: "44433322-2c4y-483z-a0a9-158621f77a21"

  - `reviewerType` (string,null)
    Type of reviewer for the current review outcome.
    Enum: "human", "bot"

  - `reviewerName` (string,null)
    First and last name of the person who reviewed the AML check.
If the result is inherited, this field is set to "bot".

  - `reviewStartTime` (string,null)
    Date and time when the AML check review is started.

  - `reviewTime` (string,null)
    Date and time when the AML check review is completed.

  - `priority` (string,null)
    Highest matched priority of all hits within an AML check.

  - `source` (string)
    Source of the AML check.
    Enum: "sign-up", "recurring", "purchase"

  - `status` (string)
    Status of the AML check.
    Enum: "pending-review", "in-review", "no-match", "confirmed-match", "false-positive"

  - `customer` (object)

  - `customer.id` (string)
    ID of the customer.

  - `customer.primaryAddress` (object)
    Customer's data at the time of the AML check.

  - `customer.primaryAddress.firstName` (string)
    Customer's first name at the time of the AML check.

  - `customer.primaryAddress.lastName` (string)
    Customer's last name at the time of the AML check.

  - `customer.primaryAddress.dob` (string,null)
    Customer's date of birth.
    Example: "1971-02-14"

  - `customer.primaryAddress.address` (string,null)
    First line of the customer's street address at the time of the AML check.
    Example: "36 Craven St"

  - `customer.primaryAddress.address2` (string,null)
    Second line of the customer's street address at the time of the AML check.

  - `customer.primaryAddress.city` (string,null)
    Customer's city of residence at the time of the AML check.
    Example: "Austin"

  - `customer.primaryAddress.region` (string,null)
    Customer's region of residence at the time of the AML check.
    Example: "Texas"

  - `customer.primaryAddress.country` (string,null)
    Customer's country of residence at the time of the AML check.

  - `customer.primaryAddress.postalCode` (string,null)
    Customer's postal code at the time of the AML check.
    Example: "WC2N 5NF"

  - `customer.organizationId` (string)
    ID of the customer's organization.
    Example: "org_0YVDM8RC7GDADADSBSMW124JA8"

  - `hits` (array)
    List of hits returned during the AML check.

  - `hits.firstName` (string)
    First name of the individual, or name of entity.
    Example: "Benjamin"

  - `hits.lastName` (string,null)
    Last name of the individual.
This field returns a null value for single-named entities.
    Example: "Franklin"

  - `hits.source` (string)
    Describes which list the result is from.

  - `hits.sourceType` (array)
    Describes the categories of the individual or entity.
    Enum: "pep", "sanctions", "adverse-media", "enforcements", "state-owned-enterprise"

  - `hits.gender` (string,null)
    If type=individual, this field describes the gender of the individual.

  - `hits.title` (array,null)
    Individual's job title.
    Example: ["Postmaster General","Ambassador to France","Ambassador to Sweden","Supreme Executive Council of Commonwealth of Pennsylvania"]

  - `hits.type` (string)
    Describes whether the source is an individual or an entity.
    Enum: "individual", "entity"

  - `hits.legalBasis` (array)
    List of references to legal documents, if they exist.

  - `hits.regime` (string,null)
    Describes the government, administration, or political entity.
    Example: "United States Government"

  - `hits.confidence` (string)
    Degree of confidence in the source list information.
    Enum: "weak", "medium", "strong", "very-strong"

  - `hits.nationality` (string)
    Nationality of the individual or entity.

  - `hits.address` (array)
    Addresses associated with the individual or entity.

  - `hits.address.address` (string,null)
    Street address line 1.

  - `hits.address.address2` (string,null)
    Street address line 2.

  - `hits.address.city` (string,null)
    City.

  - `hits.address.region` (string,null)
    State, province, or region.

  - `hits.address.country` (string,null)
    Country.

  - `hits.address.birthplace` (boolean)
    Individual's place of birth.

  - `hits.dob` (array)
    One or more possible dates of birth.
    Example: ["1706-01-17"]

  - `hits.aliases` (array)
    List of aliases, if any.

  - `hits.aliases.firstName` (string)
    First name of alias.

  - `hits.aliases.lastName` (string)
    Last name of alias.

  - `hits.aliases.authenticity` (string)
    Degree of confidence in the alias.
    Enum: "strong", "weak", "unknown"

  - `hits.passport` (array)
    Individual's passport information.

  - `hits.passport.number` (string)
    Passport number.

  - `hits.passport.registrationDate` (string)
    Passport registration date.

  - `hits.comments` (string,null)
    Additional information.
This content varies per list.

  - `hits.matchDetails` (object,null)
    Details of the matching logic and confidence scoring.

  - `hits.matchDetails.confidenceFactors` (array)
    List of factors that contributed to the confidence score calculation.
    Enum: "confidence_exact_country", "confidence_mismatch_country", "confidence_missing_country", "confidence_exact_dob", "confidence_mismatch_dob", "confidence_missing_dob", "confidence_exact_yob", "confidence_inexact_yob", "confidence_strong_hit_relevance", "confidence_weak_hit_relevance", "confidence_exact_full_name", "confidence_fuzzy_full_name"

  - `hits.matchDetails.matchCriteria` (array)
    List of specific criteria that matched against the watchlist.
    Enum: "match_exact_name", "match_phonetic_first_name", "match_phonetic_last_name", "match_exact_full_name", "match_aka_exact_name", "match_aka_phonetic_first_name", "match_aka_phonetic_last_name", "match_aka_exact_full_name", "match_fuzzy_nationality", "match_exact_address", "match_exact_city", "match_exact_region", "match_exact_country", "match_exact_post_code"

  - `hits._links` (array)
    Related links.

  - `hits._links.href` (string)
    Link URL.

  - `hits._links.rel` (string)
    Type of link.
    Enum: "self"

  - `tags` (array)
    List of AML check tags.

  - `tags.id` (string)
    ID of the tag.

  - `tags.name` (string, required)
    Unique name for the tag.
Tag names are not case-sensitive.
    Example: "New"

  - `tags.type` (string, required)
    Type of tag.
Tags of a specific type can only be assigned to corresponding entity types.
For example, you can only use customer tags on customers.
    Enum: "customer", "kyc-document", "aml-check"

  - `tags.createdTime` (string)
    Date and time when the resource is created.
This value is set automatically when the resource is created.

  - `tags.updatedTime` (string)
    Date and time when the resource is updated.
This value is set automatically when the resource is updated.

  - `tags._links` (array)
    Related links.

  - `tags._links.href` (string)
    Link URL.

  - `tags._links.rel` (string)
    Type of link.
    Enum: "self"

  - `provenance` (object,null)
    Origin of the AML check result.

  - `provenance.inherited` (boolean)
    Specifies if the result is inherited from a previous AML check.
    Example: true

  - `provenance.inheritedFromAmlCheckId` (string)
    ID of the AML check from which the check inherits its result.
    Example: "aml_chk_0YV8XJT2ZWDR398Q8NFEM7DEPM"

  - `provenance.scope` (array)
    Scope of what is inherited from the source AML check.
    Enum: "status-only"

  - `provenance.reasons` (array)
    Reasons that triggered the inheritance of the result.
    Enum: "customer_duplicated_by_person_exact_match", "customer_duplicated_by_primary_phone_number_exact_match", "customer_previous_check_exact_match"

  - `noMatchReason` (string,null)
    Reason for the no-match result.
    Enum: "no_hits_found", "mismatched_hits", "hits_are_below_relevance_score_threshold", "internal_system_error"

  - `_links` (array)
    Related links.

  - `_links.href` (string)
    Link URL.

  - `_links.rel` (string)
    Type of link.
    Enum: "self", "customer"

## Response 401 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

## Response 403 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

## Response 404 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

## Response 422 fields (application/json):

  - `status` (integer)
    HTTP status code.

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.

  - `invalidFields` (array)
    Invalid field details.

  - `invalidFields.field` (string)
    Name of the field.
Dot notation is used for nested object field names.

  - `invalidFields.message` (string)
    Message field.

## Response 429 fields (application/json):

  - `type` (string)
    Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference.
It should provide human-readable documentation for the problem type.
When this member is not present, its value is assumed to be "about:blank".
    Example: "about:blank"

  - `title` (string)
    Short, human-readable summary of the problem type.
Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem.
    Example: "Rate Limit Exceeded"

  - `status` (integer)
    HTTP status code.

  - `detail` (string)
    Human-readable explanation that is specific to this occurrence of the problem.
    Example: "A request cannot be executed because the user has sent too many requests within a certain period of time"

  - `instance` (string)
    URI reference that identifies the specific occurrence of the problem.
It may or may not yield further information if dereferenced.