# Retrieve KYC settings

Retrieves KYC settings.

Endpoint: GET /kyc-settings
Version: latest
Security: SecretApiKey, JWT

## Response 200 fields (application/json):

  - `identityProof` (object)
    Identity proof settings.

  - `identityProof.weights` (object)
    Property weights that are used for the KYC document verification process.

All KYC documents start the verification process with a score of 100.
If a check fails, the score is reduced by the corresponding weight.
For example, if the  check weight is set to , and the check fails,
the KYC document score becomes .

  - `identityProof.weights.containsImage` (integer)
    Weight added if the document does not include an image that contains a face.

  - `identityProof.weights.isIdentityDocument` (integer)
    Weight added if the document does not resemble an ID.

  - `identityProof.weights.isPublishedOnline` (integer)
    Weight added if an exact match of the document is not found online.

  - `identityProof.weights.firstName` (integer)
    Weight added if the customer's first name is not matched.

  - `identityProof.weights.lastName` (integer)
    Weight added if the customer's last name is not matched.

  - `identityProof.weights.expirationDate` (integer)
    Weight added if an expiration date is not detected on the document.

  - `identityProof.weights.dateOfBirth` (integer)
    Weight added if a date of birth is not detected on the document.

  - `identityProof.weights.matchesDateOfBirth` (integer)
    Weight added if an identity document does not have a matching date of birth.

  - `identityProof.weights.issueDate` (integer)
    Weight added if an issue date is not detected on the document.

  - `identityProof.weights.hasMinimalAge` (integer)
    Weight added if the document does not verify the minimal age limit.
Minimal age is 21+ the for USA and 18+ for all other countries.

  - `identityProof.weights.hasMatchingFaceProof` (integer)
    Weight added if an identity document does not have matching face proof.

  - `identityProof.weights.nationality` (integer)
    Weight added if a nationality is not detected on the document.

  - `identityProof.weights.documentSubtype` (integer)
    Weight added if the document is not one of the recognized document subtypes.

  - `identityProof.weights.isTampered` (integer)
    Weight added if the document has been tampered with.

  - `identityProof.thresholds` (object)
    Pass and fail threshold definition for the document verification process.

  - `identityProof.thresholds.rejectBelow` (integer)
    Overall score by which an identity proof document fails the verification process.

  - `identityProof.thresholds.acceptAbove` (integer)
    Overall score by which an identity proof document passes the verification process.

  - `addressProof` (object)
    Address proof settings.

  - `uiVersion` (string,null)
    Version of the KYC document gatherer UI.
    Enum: "1", "2"

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