# Persons

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

Endpoint: POST /bdb/persons
Security: Your API key

## Response 200 fields (application/json):

  - `data` (array)

  - `data.full_name` (string,null)
    A full name of an object, which consists of a first name and a last name

  - `data.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.first_name` (string,null)
    A first name of an object

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

  - `data.last_name` (string,null)
    A last name of an object

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

  - `data.middle_name` (string,null)
    A middle name of an object

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

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

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

  - `data.gender` (string,null)
    Gender of the individual.  indicates male,  indicates female
    Enum: "M", "F"

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

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

  - `data.bdb_type` (array)
    A type of blacklist databases to make a check
* : Global and local sanctions
databases
* : Databases of politically exposed persons (PEP)
* : Databases of persons asked for self-exclusion
* : Databases of persons being searched for by the police
* : Databases of stolen or lost documents
    Enum: "INTERNAL", "SANCTIONS", "PEP", "SELF_RESTICTED", "WANTED", "EXPIRED"

  - `data.accuracy` (integer)
    An accuracy of provided information (in percents)

## Response 400 fields (application/json):

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

  - `errors` (array)

## Response 500 fields (application/json):

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

  - `errors` (array)