# Persons v2

Retrieve information on persons from the Kycaid blacklist databases using fuzzy search to check for compliance with laws and regulations. Each response may have several objects, with one object per a blacklist

Endpoint: POST /bdb/persons-2
Version: 1.0
Security: your_api_key

## Response 200 fields (application/json):

  - `data` (object)

  - `data.parameters` (object)

  - `data.parameters.name_match_threshold` (number)
    The minimum similarity score required to include a name in the search results. A higher value returns fewer, more exact matches, and a lower value returns more results with less similarity

  - `data.parameters.name_match_weight` (number)
    Influence of a name match on the total match score

  - `data.parameters.dob_match_enabled` (boolean)
    Enable or disable inclusion of a date of birth in the total match score
    Enum: true, false

  - `data.parameters.dob_match_weight` (number)
    Influence of a date of birth match on the total match score

  - `data.parameters.residence_country_match_enabled` (boolean)
    Enable or disable inclusion of a residence country match in the total match score
    Enum: true, false

  - `data.parameters.residence_country_match_weight` (number)
    Influence of a residence country match on the total match score

  - `data.parameters.gender_match_enabled` (boolean)
    Enable or disable inclusion of a gender match in the total match score
    Enum: true, false

  - `data.parameters.gender_match_weight` (number)
    Influence of a gender match on the total match score

  - `data.result` (array)

  - `data.result.full_name` (string,null)
    The full name of a person, which includes a first and last name

  - `data.result.origin_full_name` (string,null)
    A full name of an object, which consists of a first name and a last name, set in a native language

  - `data.result.first_name` (string,null)
    The first name of a person

  - `data.result.origin_first_name` (string,null)
    A first name of an object, set in a native language

  - `data.result.last_name` (string,null)
    The last name of a person

  - `data.result.origin_last_name` (string,null)
    A last name of an entity, set in a native language

  - `data.result.middle_name` (string,null)
    The middle name of a person

  - `data.result.origin_middle_name` (string,null)
    A middle name of an object, set in a native language

  - `data.result.dob` (string,null)
    The date of birth of a person, formatted according to ISO 8601

  - `data.result.residence_country` (string,null)
    A residence country of an object. A two-letter country code according to ISO 3166-2

  - `data.result.gender` (string,null)
    The gender of a person.  indicates male;  indicates female
    Enum: "M", "F"

  - `data.result.description` (string,null)
    The detailed description of a status in blacklist databases

  - `data.result.bdb_name` (string,null)
    A name of a blacklist database

  - `data.result.aliases` (array)

  - `data.result.addresses` (array)

  - `data.result.name_match_score` (number)
    Relevance of a name match in a fuzzy search

  - `data.result.total_match_score` (number)
    The calculated relevance score for a search result

## Response 400 fields (application/json):

  - `type` (string)
    Example: "bad_request"

  - `errors` (array)

## Response 429 fields (application/json):

  - `type` (string)
    Example: "flow"

  - `errors` (array)

  - `errors.parameter` (string)
    Example: "limit_exceeded"

  - `errors.message` (string)
    Example: "Rate limit exceeded"

## Response 500 fields (application/json):

  - `type` (string)
    Example: "internal_server"

  - `errors` (array)