# Базы данных

Нам доступны:

* ИНН физического лица
* Действующие исполнительные производства из открытых источников главного управления по вопросам миграции МВД России
* Архивные исполнительные производства из закрытых источников
* Данные о розыске в открытых источниках ФССП
* Данные о розыске из открытых источников ФСИН
* Данные о наличии в списках экстремистов и террористов Росфинмониторинга
* Данные о наличии в реестре залогов федеральной нотариальной палаты
* Данные о розыске по данным открытых источников МВД
* Данные о наличии в чёрных списках компаний в сфере каршеринга, проката, грузоперевозок, банков и МФО
* Данные о наличии в эталонных базах данных человека с такой связкой ФИО, даты рождения и серии-номера паспорта
* Данные о наличии серии-номера паспорта в списке недействительных паспортов МВД
* Данные о наличии в реестре дисквалифицированных лиц
* Данные о наличии судимости
* Данные о наличии в списке публичных должностных лиц\\

Список проверок, которые мы можем оперативно добавить в API по запросу:

* Проверка паспорта по списку недействительных паспортов
* Проверка связки ФИО + ДР / паспорта и ИНН
* Проверка ФЛ на банкрота
* Проверка ФЛ на наличие в списке номинальных ГД
* Проверка ФЛ на наличие статуса ИП
* Проверка ФЛ на участие в ЮЛ
* Проверка ФЛ на дисквалификацию
* Проверка ФЛ на ограничение в участие ЮЛ
* Проверка ФЛ на получение статуса самозанятого
* Проверка ФЛ по арбитражным делам
* Проверка ФЛ на долги за налоги
* Подтверждение связки ФИО–телефон
* Проверка совершеннолетия
* Проверка на вероятность «дропа»
* Наличие двойного гражданства
* Верификация через Госуслуги
* Подтверждение связки email–телефон, ФИО
* Проверка тегов по телефону на наличие ключевых слов (жулик, мошенник, вор и пр.)
* Проверка связи между ФЛ
* Проверка срока жизни / оценка активности телефонного номера
* Проверка водительского удостоверения
* Получение СНИЛС, серии и номера паспорта по ФИО и ДР
* Скоринг благонадёжности
* Скоринг на мошенничество

{% hint style="info" %}
Если вам не хватает какой-то проверки, скорее всего, она у нас уже есть. Напишите нам в[ телеграм](https://t.me/dbrain_support_bot) или на <hello@dbrain.io>, и мы добавим её в API
{% endhint %}

{% hint style="success" %}
Чтобы воспользоваться сервисом, отправьте POST-запрос на URL `https://latest.dbrain.io/check/external`
{% endhint %}

## Параметры запроса к API

{% hint style="success" %}
**Асинхронный запрос**

<mark style="color:green;">**async**</mark> — boolean

Поведение по умолчанию: `async=false` — сервис обрабатывает запросы синхронно. При отправке запроса вы получите ответ только после окончательного завершения обработки запроса сервисом.

Если вам нужен асинхронный режим, укажите в запросе `async=true`. В ответ на запрос сервис вернёт в `response body` параметр `task_id`. Например:

```json
"task_id": "96b8ccc950a70699927036842c624d7c"
```

Используйте этот `task_id`, чтобы получить результат работы сервиса в методе `result`:

```bash
curl -X 'GET' \
  'https://latest.dbrain.io/result/96b8ccc950a70699927036842c624d7c?token=XXX' \
  -H 'accept: application/json'
```

Не забудьте указать в параметре `token` ваш ключ лицензии. Рекомендуем запрашивать метод `result` в цикле с периодом 1-2 секунды.
{% endhint %}

{% hint style="success" %}
**Тегирование запроса**

<mark style="color:green;">**task\_tags**</mark> — string array

Поведение по умолчанию: параметр не используется.

Функция тегирует запросы по вашему усмотрению. Это упрощает отслеживание пакетов документов, связанных с конкретным клиентом-физлицом. Для использования функции укажите в параметре `task_tags` удобный вам тег: `task_tags=тэг`
{% endhint %}

{% hint style="success" %}
**Получение ИНН физического лица**

<mark style="color:green;">**get\_inn**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `inn`
{% endhint %}

{% hint style="success" %}
**Получение действующих исполнительных производств из открытых источников главного управления по вопросам миграции МВД России**

<mark style="color:green;">**get\_current\_enforcements**</mark> **— boolean**

* **true** — получить данные
* **false** (по умолчанию) — не получать данные

Ответ приходит в поле `current_enforcements`
{% endhint %}

{% hint style="success" %}
**Получение архивных исполнительных производств из закрытых источников**

<mark style="color:green;">**get\_archive\_fssp**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `archive_fssp`
{% endhint %}

{% hint style="success" %}
**Получение данных о розыске человека в открытых источниках ФССП**

<mark style="color:green;">**is\_fssp\_wanted**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_fssp_wanted`
{% endhint %}

{% hint style="success" %}
**Получение данных о розыске человека из открытых источников ФСИН**

<mark style="color:green;">**is\_fsin\_wanted**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_fsin_wanted`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии человека в списках экстремистов и террористов Росфинмониторинга**

<mark style="color:green;">**is\_terrorist**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_terrorist`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии человека в реестре залогов федеральной нотариальной палаты**

<mark style="color:green;">**is\_in\_pledge\_registry**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не данные

Ответ приходит в поле `is_in_pledge_registry`
{% endhint %}

{% hint style="success" %}
**Получение данных о розыске человека по данным открытых источников МВД**

<mark style="color:green;">**is\_mvd\_wanted**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_mvd_wanted`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии человека в чёрных списках компаний в сфере каршеринга, проката, грузоперевозок, банков и МФО**

<mark style="color:green;">**is\_in\_black\_list**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные о наличии в чёрных списках

Ответ приходит в поле `is_in_black_list`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии в эталонных базах данных человека с такой связкой ФИО, даты рождения и серии-номера паспорта**

<mark style="color:green;">**is\_fio\_birthday\_passport\_verified**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_fio_birthday_passport_verified`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии серии-номера паспорта в списке недействительных паспортов МВД**

<mark style="color:green;">**is\_passport\_expired**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_passport_expired`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии человека в реестре дисквалифицированных лиц**

<mark style="color:green;">**is\_in\_disqualified\_list**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_in_disqualified_list`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии судимости**

<mark style="color:green;">**is\_criminal**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_criminal`
{% endhint %}

{% hint style="success" %}
**Получение данных о наличии человека в списке публичных должностных лиц**

<mark style="color:green;">**is\_in\_pdl\_list**</mark> — boolean

* true — получить данные
* false (по умолчанию) — не получать данные

Ответ приходит в поле `is_in_pdl_list`
{% endhint %}

## Тело запроса к API

{% hint style="success" %}
**Изображение**

<mark style="color:green;">**image**</mark> — string ($binary)

Изображение обязательно для передачи в запросе. Сервис ожидает изображение [главного разворота паспорта РФ](https://docs.dbrain.io/servisy/izvlechenie-dannykh/pasport) в двоичном виде. Рекомендуем брать его из ответа сервиса [«Классификация документов»](https://docs.dbrain.io/servisy/document-classification).
{% endhint %}

## В ответе на запрос к API:

{% hint style="info" %}
Перед началом работы с сервисами изучите раздел [«Общая информация о сервисах»](https://docs.dbrain.io/obshaya-informaciya/readme). Там мы рассказываем про допустимые форматы файлов, виды запросов и ответов, набор HTTP-статусов и даём рекомендации по устранению ошибок
{% endhint %}

<table data-header-hidden><thead><tr><th width="183">Название</th><th width="126.33333333333331">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>task_id</td><td>string</td><td>Идентификатор запроса, формат: 32 символа, 16-ричная строка</td></tr><tr><td>error</td><td>string</td><td>Текстовое описание ошибки</td></tr><tr><td>task_tags</td><td>array[string]</td><td>Теги, если они переданы в параметре task_tags</td></tr><tr><td>success</td><td>boolean</td><td>Статус запроса</td></tr><tr><td>status_code</td><td>integer</td><td><p>HTTP-код статуса запроса</p><ul><li>200 — запрос выполнен успешно</li><li>400, 403, 500 и т.д. — расшифрованы в «<a href="../../../obshaya-informaciya/readme#http-kody-otveta-na-zapros">общей информации о сервисах</a>»</li></ul></td></tr><tr><td>inn</td><td>integer</td><td><ul><li>123456789000 — Найден ИНН</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>current_enforcements</td><td>integer</td><td><ul><li>1234 — Найден (в рублях)</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>archive_fssp</td><td>integer</td><td><ul><li>1234 — Найден (в рублях)</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_fssp_wanted</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_fsin_wanted</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_terrorist</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_in_pledge_registry</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_mvd_wanted</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_in_black_list</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_fio_birthday_passport_verified</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_passport_expired</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_in_disqualified_list</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_criminal</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr><tr><td>is_in_pdl_list</td><td>integer</td><td><ul><li>1 — Найден</li><li>0 — Не найден</li><li>-1 — Источник не ответил</li><li>-2 — Проверка не оплачена</li><li>-3 — Не удалось извлечь нужные поля из документа</li></ul></td></tr></tbody></table>