Главная → Блог → Как проверить авто на запрет регистрационных действий через API

Как проверить авто на запрет регистрационных действий через API

27 октября 2026 · Редакция AvtoVinCod · 7 мин чтения

Запреты на регистрационные действия, аресты и розыск проверяются одним запросом GET /score?vin= (для авто без VIN: /score-body?body=). В ответе приходят тип ограничения, основание, регион, номер исполнительного производства и признак розыска, а поле found показывает, есть ли VIN в базе ГИБДД. Подключение занимает минуты: токен выдаётся сразу, пополнение от 100 ₽, тестовый VIN X7TEST00000000001 отвечает бесплатно.

Почему ручная проверка на сайте ГИБДД не работает для бизнеса

Одну машину можно проверить руками за минуту. Сто машин в неделю по выкупу, трейд-ину или входящему потоку объявлений - уже полставки сотрудника, который копирует VIN в форму и переписывает результат в CRM. Ошибки неизбежны: перепутанная буква, пропущенный запрет, забытая повторная проверка.

Бизнесу нужен ответ в JSON, который система разбирает сама: чисто - карточка идёт дальше, есть ограничение - сделка встаёт на паузу и уходит юристу. Менеджер в этой цепочке не нужен.

Какие ограничения важны перед сделкой: запрет на регистрационные действия, арест и розыск. Мы не даём юридических оценок, только данные: что наложено, кем, в каком регионе и по какому производству. Выводы делает ваша служба безопасности или юристы. Подробнее о типах ограничений - в материале проверка ограничений ГИБДД через API.

Метод /score: что приходит в ответе

Метод /score: ограничения и розыск возвращает запреты на регистрационные действия, розыск и периоды владения. Авторизация - Bearer-токен из личного кабинета.

Запрос на cURL:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/score?vin=X7TEST00000000001"

То же на Python:

import requests

r = requests.get(
 "https://api.avtovincod.ru/score",
 params={"vin": "X7TEST00000000001"},
 headers={"Authorization": "Bearer ВАШ_ТОКЕН"},
 timeout=60,
)
data = r.json()
print(data.get("found"), r.headers.get("X-Charged"))

Адрес хоста сверьте с разделом документации: в примерах на странице метода он уже подставлен.

Что смотреть в ответе

По каждому запрету приходит тип ограничения, основание, регион наложения и номер исполнительного производства (enforcement_number). Отдельно - признак розыска. Плюс периоды владения: даты регистрации и снятия, по ним видно, сколько собственников сменилось. Именно enforcement_number пригодится дальше, если нужно узнать, за что наложен запрет.

Поле found: 1 и 0

found = 1 значит, что VIN есть в базе ГИБДД и данные получены. Пустой список ограничений при этом - реальный результат "чисто".

found = 0 значит другое: VIN в базе не найден. Это не "чисто". Причин несколько: опечатка в VIN, машина не стояла на учёте в России, ввезена недавно, у неё нет VIN в привычном виде. В логике принятия решения такой статус нужно вести отдельной веткой, иначе вы однажды примете "не нашли" за "нет запретов".

Стоимость и блок billing

По прайсу запрос /score стоит 20 ₽. В каждом ответе, записанном в историю, есть блок billing (charged, currency, billed, balance, requestId) и заголовки X-Charged, X-Balance, X-Request-Id. Нет блока - запрос не списан. Удобно сверять в коде: если ответ получен, а charged пустой, значит, списания не было.

Тестовый режим

Интеграцию можно отладить без пополнения. Тестовые значения (VIN X7TEST00000000001, госномер Т000ТТ00, номер кузова TEST-0000001) возвращают образец по схеме метода с полем "testMode": true. Бесплатно, но токен нужен. Прогоните через него весь парсер, включая ветки с ограничением и без.

Если у машины нет VIN или известен только госномер

Японские машины и другие авто без VIN идентифицируются по номеру кузова: GET /score-body?body=. Структура ответа та же, что у /score, парсер менять не нужно.

Если от клиента пришёл только госномер, сначала получить VIN по госномеру: GET /gos2vin?plate= вернёт VIN, номер кузова или шасси, СТС, марку, модель, год и мощность. Метод стоит 8 ₽, а уже с готовым VIN вы идёте в /score. Вручную подставлять ничего не надо.

Перед основным запросом полезно сверить данные: /brief (1 ₽) отдаёт марку, модель, год, мощность и тип двигателя, а /decode (1,6 ₽) расшифровывает VIN. Если клиент говорит "Camry 2018", а по VIN выходит другая модель, лучше узнать об этом до оплаты дорогих проверок.

Логика принятия решения: светофор для сделки

Правила простые:

• Красный: розыск или действующий запрет. Стоп, передаём человеку.
• Жёлтый: found = 0 или ошибка источника. Ручная проверка или повтор запроса.
• Зелёный: found = 1, ограничений нет. Идём дальше по конвейеру.

Функция-классификатор на Python:

def classify(resp: dict) -> str:
 if resp.get("found") == 0:
 return "yellow"
 if resp.get("wanted"):
 return "red"
 if resp.get("restrictions"):
 return "red"
 return "green"

Названия полей wanted и restrictions здесь условные: сверьте их со схемой на странице метода и подставьте реальные. Логика остаётся той же. Если запреты бывают снятые или исторические, добавьте фильтр по статусу, чтобы не отправлять в красную зону прошлое.

Что /score не проверяет

Залог, лизинг и долги - отдельные реестры. Чистый /score не значит, что машина свободна от обременений. Для этого есть смежные методы, о них дальше.

Связка с другими проверками в одном конвейере

Типичный порядок для выкупа или площадки:

1. /score - запреты, арест, розыск (20 ₽).
2. Реестр залогов ФНП - /pledge (2,4 ₽).
3. /lizing - договоры лизинга (2,2 ₽).
4. /accidents - архивные ДТП (0,8 ₽).
5. /lawsuits - арбитражные дела по машине (3 ₽).

Если в /score есть запрет, берём enforcement_number и запрашиваем долги у судебных приставов по API: GET /enforcement?number= по цене 0,65 ₽. В ответе видно статус производства, сумму и вид долга (штраф, налог, кредит, алименты), поэтому юрист сразу понимает масштаб проблемы. Платно, если источник ответил, в том числе когда долгов нет.

Стоимость полного пакета на одну машину по прайсу: 20 + 2,4 + 2,2 + 0,8 + 3 = 28,4 ₽. Добавьте /enforcement по найденному производству, и выйдет 29,05 ₽. Если нужен ещё и полный разбор по ДТП и розыску, смотрите проверку ДТП и розыска при выкупе, а общую схему отчёта - в статье полный отчёт по VIN для бизнеса.

Практический приём: запускайте дорогие и важные проверки первыми и останавливайте конвейер на красном. Зачем платить за судебные дела по машине, которая в розыске?

Сценарии для разных бизнесов

Выкуп и трейд-ин. Проверка на входе, до оценки. Оценщик не тратит время на машину, которую нельзя оформить, а клиенту сразу называют причину.

Автосалон и площадка объявлений. В карточке хранится статус проверки и дата. Площадка может показывать значок "проверено по ГИБДД" только после зелёного результата, а спорные карточки отправлять на модерацию.

Лизинг и страховые. Проверка перед выдачей договора и далее по графику: ограничение может появиться уже после подписания. Для периодического контроля удобнее мониторинг, чем самописный планировщик.

Без кода. Массовая проверка без кода принимает до 100 машин файлом Excel или CSV, показывает расчёт "не больше" до запуска и присылает таблицу с отчётом на почту и в Telegram. А мониторинг автомобилей с вебхуком сам следит за списком и сообщает только об изменениях: новый запрет, арест, розыск, смена собственника. Вебхук приходит POST-запросом с JSON и подписью X-AVC-Signature (HMAC-SHA256 тела).

Ошибки интеграции и как их избежать

Долгое кэширование. Ограничения меняются: утром чисто, к вечеру наложен запрет. Хранить результат неделями нельзя. Кэш на несколько часов для повторных просмотров карточки допустим, для решения по сделке - нет.

Нет повторной проверки перед подписанием. Между оценкой и договором проходят дни. Сделайте обязательный повторный /score в день подписания: 20 ₽ против риска сорвать сделку.

Нет обработки сбоев. Ошибки и сбои источника не списываются, поэтому ретрай безопасен. Ставьте повтор с паузой и лимитом попыток, а после лимита переводите карточку в жёлтый статус, а не в зелёный по умолчанию.

Нет аудита. Сохраняйте requestId из блока billing вместе с VIN, временем и вердиктом классификатора. Когда через месяц спросят, на каком основании машину признали чистой, у вас будет запись, а при обращении в поддержку - идентификатор запроса.

Начать можно в личном кабинете: регистрация за минуту, токен сразу, договор не нужен.

Читайте также

Бот для проверки авто в Telegram на API: за вечер

Проверить техосмотр по базе ЕАИСТО через API: гос номер и VIN

Проверить обременение на автомобиль: залог через API ФНП