Документация по работе с API МВДHTTPS GET запрос: https://api-cloud.ru/api/mvd.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| rkl | Поиск в реестре контролируемых лиц Если метод работает плохо или не работает в момент обращения, то воспользуйтесь методом rklv2
• Найдено или нет лицо в реестре контролируемых лиц
|
Обязательные fio - Фамилия, Имя, Отчество (при наличии) Разрешено: [A-Za-zА-ЯЁа-яё\s] birthdate - Дата рождения в формате: ДД.ММ.ГГГГ - В документе полная дата рождения (год, месяц, день) ММ.ГГГГ - Отсутствует день рождения ГГГГ - Отсутствует месяц и день рождения Разрешено: [0-9.\s] docnum - Серия и номер документа, удостоверяющего личность Разрешено: [A-Za-zА-ЯЁа-яё0-9\s], максимальное количеств символов: 24 docdate - Дата выдачи документа, удостоверяющего личность (ДД.ММ.ГГГГ) token - персональный ключ API |
| rklv2 beta | Поиск в реестре контролируемых лиц (Новая версия)
• Найдено или нет лицо в реестре контролируемых лиц
|
Обязательные birthdate - Дата рождения в формате: ДД.ММ.ГГГГ - В документе полная дата рождения (год, месяц, день) ММ.ГГГГ - Отсутствует день рождения ГГГГ - Отсутствует месяц и день рождения Разрешено: [0-9.\s] docnum - Серия и номер документа, удостоверяющего личность Разрешено: [A-Za-zА-ЯЁа-яё0-9\s], максимальное количеств символов: 24 docdate - Дата выдачи документа, удостоверяющего личность (ДД.ММ.ГГГГ) token - персональный ключ API |
| patent | Проверка действительности патентов на осуществление трудовой деятельности иностранными гражданами и лиц без гражданства Если метод работает плохо или не работает в момент обращения, то воспользуйтесь методом patentv2
• Действие патента
|
Обязательные docseria - Серия документа Разрешено: [A-Za-z0-9-\s] docnumber - Номер документа Разрешено: [A-Za-z0-9-\s] blankseria - Серия бланка документа Разрешено: [A-Za-zА-ЯЁа-яё0-9-\s] blanknumber - Номер бланка документа Разрешено: [A-Za-z0-9-\s] lbg - Серия и номер паспорта ИГ (ЛБГ) Разрешено: [A-Za-z0-9-\s] token - персональный ключ API |
| patentv2 beta | Проверка действительности патентов на осуществление трудовой деятельности иностранными гражданами и лиц без гражданства (Новая версия)
• Действие патента
|
Обязательные docseria - Серия документа Разрешено: [A-Za-z0-9-\s] docnumber - Номер документа Разрешено: [A-Za-z0-9-\s] blankseria - Серия бланка документа Разрешено: [A-Za-zА-ЯЁа-яё0-9-\s] blanknumber - Номер бланка документа Разрешено: [A-Za-z0-9-\s] lbg - Серия и номер паспорта ИГ (ЛБГ) Разрешено: [A-Za-z0-9-\s] token - персональный ключ API |
| chekpassportv2 На тестировании, Ограниченный тест |
Проверка паспорта РФ на действительность (Актуальные данные на момент запроса, НЕ КЭШ, не база)
• Действительный (VALID)
• Недействительный (NOT_VALID)
• Не найден (NOT_FOUND)
|
Обязательные seria - Серия паспорта Разрешено: [0-9] nomer - Номер паспорта Разрешено: [0-9] lastname - Фамилия Разрешено: [A-Za-zА-ЯЁа-яё0-9-\s] firstname - Имя Разрешено: [A-Za-zА-ЯЁа-яё0-9-\s] token - персональный ключ API |
| stopOperRS | Действующие приостановления операций по счетам по указанному налогоплательщику
• ИНН налогоплательщика
• Название налогоплательщика
• Код налогового органа
• Дата приостановления операций по счетам
• БИК банка, в котором приостановлены операции
• Номер приостановления
• Дата и время размещения информации в сервисе (Мск)
• Код основания
• Расшифровка кода основания
• Размер отрицательного сальдо ЕНС*, руб.коп
|
Обязательные inn - ИНН налогоплательщика Разрешено: [0-9] token - персональный ключ API |
| chekpassport | Проверка паспорта РФ на действительность
Данные могут быть неактуальны (база от 21 июня 2023 года)
Поиск осуществляется по последней архивной базе
• Cреди недействительных не значится
• Не действителен Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)
• Не действителен (ТЕХНИЧЕСКИЙ БРАК)
• Не действителен (ЗАМЕНЕН НА НОВЫЙ)
• Не действителен (УТРАТА ПАСПОРТА)
• Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)
|
Обязательные seria - Серия паспорта Разрешено: [0-9\s] nomer - Номер паспорта Разрешено: [0-9\s] token - персональный ключ API |
| wanted new | Поиск лица в базе данных «Розыск МВД»
• Указанное лицо найдено в базе розыска
• Указанное лицо не найдено в базе розыска
|
Обязательные lastname - Фамилия Маска: [A-Za-zА-ЯЁа-яё-\s] firstname - Имя Разрешено: [A-Za-zА-ЯЁа-яё-\s] birthdate - дата рождения Разрешено: [YYYY], [mm.YYYY], [dd.mm.YYYY] token - персональный ключ API |
function get_rez($url) {
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ
$res = curl_exec($ch);
curl_close($ch);
return $res;
}
$data = [
'type' => 'Тип запроса (type)',
...
Необходимы для запроса параметры
...
'token' => 'Токен',
];
// Структурированная ссылка для GET запроса
$url = 'https://api-cloud.ru/api/mvd.php?' . http_build_query($data);
$data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
https://api-cloud.ru/api/mvd.php?type=rkl&fio=ФИО&docnum=40175861&docdate=23.10.2017&birthdate=20.04.1978&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // true - найдено в реестре / false - не найдено
"inquiry": {
"price": 0.3,
"balance": 961.36,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 2,
"attempts": 2
}
}
https://api-cloud.ru/api/mvd.php?type=rkl&docnum=40175861&docdate=23.10.2017&birthdate=20.04.1978&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // true - найдено в реестре / false - не найдено
"inquiry": {
"price": 0.3,
"balance": 961.36,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 2,
"attempts": 2
}
}
https://api-cloud.ru/api/mvd.php?type=patent&docseria=11&docnumber=2500010000&blankseria=ХХ&blanknumber=4555000&lbg=404438598&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // Флаг успешности поиска патенка (true - патент найден / false - патент не найден)
"valid": true, // Действительность патента (true - патент действителен, false - не действителен, null в случае, если found => false)
"inquiry": {
"price": 0.3,
"balance": 679.41,
"credit": 20000,
"speed": 27,
"attempts": 2
}
}
https://api-cloud.ru/api/mvd.php?type=patentv2&docseria=11&docnumber=2500010000&blankseria=ХХ&blanknumber=4555000&lbg=404438598&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // Флаг успешности поиска патенка (true - патент найден / false - патент не найден)
"valid": true, // Действительность патента (true - патент действителен, false - не действителен, null в случае, если found => false)
"inquiry": {
"price": 0.3,
"balance": 679.41,
"credit": 20000,
"speed": 27,
"attempts": 2
}
}
https://api-cloud.ru/api/mvd.php?type=chekpassportv2&seria=0*14&nomer=25**55&lastname=ФАМИЛИЯ&firstname=ИМЯ&token=53ba1b7a55abbB014aa97eff3a522079
// Паспорт действительный
{
"status": 200, // Статус ответа
"result": "VALID", // Ответ валидности
"description": "ДЕЙСТВИТЕЛЬНЫЙ", // Описание
"inquiry": {
"price": 0.3, // Цена запроса
"balance": 1000.53, // Баланс после текущего запроса
"credit": 20000, // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость обработки
"attempts": 1 // Количество попыток получения результатов
}
}
// Паспорт недействительный
{
"status": 200, // Статус ответа
"result": "NOT_VALID", // Ответ валидности
"description": "НЕДЕЙСТВИТЕЛЬНЫЙ", // Описание
"inquiry": {
"price": 0.3, // Цена запроса
"balance": 1000.53, // Баланс после текущего запроса
"credit": 20000, // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость обработки
"attempts": 1 // Количество попыток получения результатов
}
}
// Паспорт не найден
{
"status": 200, // Статус ответа
"result": "NOT_FOUND", // Ответ валидности
"description": "НЕ НАЙДЕН", // Описание
"inquiry": {
"price": 0.3, // Цена запроса
"balance": 1000.53, // Баланс после текущего запроса
"credit": 20000, // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость обработки
"attempts": 1 // Количество попыток получения результатов
}
}
https://api-cloud.ru/api/mvd.php?type=stopOperRS&inn=1111111111&token=53ba1b7a55abbB014aa97eff3a522079
// Есть результат
{
"status": 200, // Статус ответа
"found": true, // Флаг результата поиска true - найдено, false - не найдено
"count": 2, // Количество записей
// Массив с результатами
"result": [
{
"inn": "1111111111", // ИНН налогоплательщика
"name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ТЕСТОВОЕ\"", // Название налогоплательщика
"code_fns": "7838", // Код налогового органа
"date": "01.08.2025", // Дата приостановления операций по счетам
"bik": "044030786", // БИК банка, в котором приостановлены операции
"number": "324044", // Номер приостановления
"date_add_info": "01.08.2025 08:55:33", // Дата и время размещения информации в сервисе (Мск)
"code_osnov": "01", // Код основания
"code_detail": "Принятие налоговым органом решения о взыскании задолженности", // Расшифровка кода основания
"saldo_ens": "3422.51" // Размер отрицательного сальдо ЕНС*, руб.коп
},
{
"inn": "1111111111",
"name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ТЕСТОВОЕ\"",
"code_fns": "7838",
"date": "01.08.2025",
"bik": "044525104",
"number": "324043",
"date_add_info": "01.08.2025 08:55:33",
"code_osnov": "01",
"code_detail": "Принятие налоговым органом решения о взыскании задолженности",
"saldo_ens": "3422.51"
}
],
"inquiry": {
"price": 0.3,
"balance": 371.95,
"credit": 20000,
"speed": 3,
"attempts": 2
}
}
// Результата нет
{
"status": 200,
"found": false,
"count": 0,
"result": [],
"inquiry": {
"price": 0.3,
"balance": 371.65,
"credit": 20000,
"speed": 2,
"attempts": 2
}
}
https://api-cloud.ru/api/mvd.php?type=chekpassport&seria=0*14&nomer=25**55&token=53ba1b7a55abbB014aa97eff3a522079
// Среди недействительных не значится
{
"status": 200,
// Результат: 0 не значится среди недействительных
"rezultat": 0,
"info": "По Вашему запросу о действительности паспорта РФ 0*14 № 25**55 получен ответ о том, что данный паспорт «Cреди недействительных не значится».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)
{
"status": 200,
// Результат: 1 значит Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)
"rezultat": 1,
"info": "По Вашему запросу о действительности паспорта РФ 0000 № 000000 получен ответ о том, что данный паспорт «Не действителен Не действителен (ИЗЬЯТ, УНИЧТОЖЕН)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (ТЕХНИЧЕСКИЙ БРАК)
{
"status": 200,
// Результат: 2 значит Не действителен (ТЕХНИЧЕСКИЙ БРАК)
"rezultat": 2,
"info": "По Вашему запросу о действительности паспорта РФ 0000 № 000000 получен ответ о том, что данный паспорт «Не действителен (ТЕХНИЧЕСКИЙ БРАК)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (ЗАМЕНЕН НА НОВЫЙ)
{
"status": 200,
// Результат: 3 значит Не действителен (ЗАМЕНЕН НА НОВЫЙ)
"rezultat": 3,
"info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (ЗАМЕНЕН НА НОВЫЙ)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (УТРАТА ПАСПОРТА)
{
"status": 200,
// Результат: 4 значит Не действителен (ЗАМЕНЕН НА НОВЫЙ)
"rezultat": 4,
"info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (ЗАМЕНЕН НА НОВЫЙ)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
{
"status": 200,
// Результат: 5 значит Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
"rezultat": 5,
"info": "По Вашему запросу о действительности паспорта РФ 4103 № 118993 получен ответ о том, что данный паспорт «Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
// Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)
{
"status": 200,
// Результат: 5 значит Не действителен (В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА)
"rezultat": 6,
"info": "По Вашему запросу о действительности паспорта РФ 4508 № 481275 получен ответ о том, что данный паспорт «Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)».",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/mvd.php?type=wanted&lastname=Гордон&firstname=Дмитрий&birthdate=1967&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"found": true, // Флаг успешности поиска (true - найдены результаты / false - отсутствуют)
"count": "1", // Количество найденных записей
// Массив с результатами поиска
"result": [
{
"img": "//static.mvd.ru/upload/site1/document_attention/3TqphQTb5f-98xx98.jpg", // Фото с базы МВД
"fio": "ГОРДОН ДМИТРИЙ ИЛЬИЧ" // ФИО
}
],
"inquiry": {
"price": 0.3,
"balance": 10000.12,
"credit": 20000,
"speed": 13,
"attempts": 2
}
}
// При попытке отправить итоговый запрос мы получили ответ, что источник недоступен
{"status":404,"error":9000,"message":"Ресурс источник недоступен"}
// Источник доступен, но ответ ресурса выходит за задокументированные рамки
{"status":404,"error":1,"message":"Нет ответа от ресурса источника"}
// Источник доступен, но в решении капчи допущена ошибка
{"status":404,"error":1,"message":"Незадокументированный ответ источника. Возможно не верно были переданы seria или nomer"}
| дата | что изменилось |
|---|---|
| 27.08.2025 | Добавлен новый метод запроса: patentv2 |
| 27.08.2025 | Добавлен новый метод запроса: rklv2 |
| 23.08.2025 | Добавлен новый метод "wanted" - Поиск лица в базе данных «Розыск МВД» |
| 01.08.2025 | Добавлен новый метод запроса. |
| 07.05.2025 | Метод rkl: |
| 13.03.2025 | Добавлен новый метод: patent |
| 21.02.2025 | Добавлен метод rkl, позволяет осуществить поиск по Реестру контролируемых лиц в официальном источнике МВД |
| 11.08.2023 | API запущен по архивному поиску по БД (данные с официального источника) до момента официального запуска источника. |
| 14.07.2023 | Добавили вывод ошибки когда источник становится не доступен. Средства за такие запросы не списываются. |
| 28.12.2022 | 1. Установили фильтрацию входящих параметров seria и nomer |
| 28.10.2022 | Проведена оптимизация, исплавлены баги, которые вызывали ошибку таймаута. |
| 23.10.2022 | В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. |
| 05.03.2022 | Добавлены попытки получить результат в случае неудачи. |
| 18.02.2022 | Стабилизировали работу. Переделан алгоритм получения информации, который позволил уменьшить количество ошибок "Повторите запрос" |
| 26.01.2022 | Новый результат |
| 21.01.2022 | Новый результат |
| 13.01.2022 | Новый результат |
| 18.11.2021 | Информация о запросе в массиве inquiry |
| код (error) | Описание ошибки (message) |
|---|---|
| 9000 | Ресурс источник недоступен Ресурс источник недоступен. Повторите запрос позже. |
| 1000 | MISSING_MANDATORY_PARAMETERS Отсутствуют обязательные параметры |
| 888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
| 766 | MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры |
| 602 | TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса |
| 504 | TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой |
| 503 | TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе |
| 502 | MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token |
| 500 | MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type |
| 499 | WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа. |
| 498 | TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс. |
| 460 | NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры |
| 456 | MAX_LIMIT Превышено количество одновременных соединений (потоки) |
| 404 | TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
| 123 | IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК |
| 111 | PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}