Главная → Блог → API ГИБДД для бизнеса: как получить данные по VIN и госномеру через интеграцию

API ГИБДД для бизнеса: как получить данные по VIN и госномеру через интеграцию

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

Чтобы получить данные ГИБДД по VIN и госномеру, достаточно одного Bearer-токена и GET-запросов к api.avtovincod.ru: из госномера получаете VIN (/gos2vin), затем запрашиваете нужные проверки по VIN. Регистрация занимает минуту, пополнение от 100 ₽, без договора. Отладка идёт на тестовых значениях бесплатно, а списание происходит только за выполненную проверку.

Что бизнес получает через API ГИБДД и зачем встраивать его в процесс

Ручная проверка выглядит так: сотрудник открывает сайт, вбивает VIN, ждёт, копирует результат в CRM или в заключение. На десяти машинах в неделю это терпимо. На двухстах в день уже нет: растёт очередь, появляются опечатки в VIN, а результаты лежат в скриншотах, по которым нельзя ничего посчитать.

Интеграция убирает эти три проблемы сразу. Скорость: быстрые методы отвечают за доли секунды, и проверка происходит в момент, когда менеджер сохраняет карточку машины. Масштаб: сто параллельных заявок - это сто запросов, а не сто человеко-часов. Единый формат: всё приходит в JSON с одинаковой оболочкой (success, данные, блок billing), поэтому правила вида "отказать, если есть запрет на регистрационные действия" пишутся одной строкой кода.

Где это применяют на практике:

• автосалоны и трейд-ин: оценка машины на приёмке, до того как названо число клиенту;
• лизинг и страховые: проверка предмета лизинга или страхования при оформлении и перед продлением;
• маркетплейсы и доски объявлений: проверка VIN из объявления и значок "проверено" в карточке;
• автопарки и логистика: контроль штрафов, пропусков и телеметрии по своим машинам.

Обзор возможностей по направлениям собран на страницах API ГИБДД в JSON и API проверки авто по VIN и номеру кузова. Здесь не будем их пересказывать, а разберём, как всё это собрать в рабочую интеграцию.

Подключение за 10 минут: токен, баланс, тестовый режим

Регистрация в личном кабинете занимает около минуты, токен выдаётся сразу. Баланс пополняется банковской картой от 100 ₽ (чек уходит на email) или по счёту для юрлиц: тогда в конце месяца приходят акт и акт сверки. Договор не нужен. Депозит действует 90 дней, поэтому закладывайте в процессы не "залить и забыть", а регулярное пополнение под реальный расход.

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

Первый запрос:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/gos2vin?plate=Т000ТТ00"

В ответе, записанном в историю запросов, будет блок billing с полями charged, currency, billed, balance и requestId. Те же данные дублируются в заголовках X-Charged, X-Balance и X-Request-Id. Если блока нет, запрос не списан. На тестовых значениях это удобный способ убедиться, что ваш код правильно читает стоимость, ещё до первой реальной проверки.

Идентификаторы: что есть на входе и как получить недостающее

На входе у вас редко всё сразу. Менеджер знает госномер, в объявлении указан VIN, у импортной машины VIN вообще нет, только номер кузова. Под каждый случай есть своя точка входа.

Метод VIN по госномеру стоит 8 ₽ и является воротами для всех сценариев, где вход - номер на кузове. Обратное направление, госномер по VIN, обойдётся в 6 ₽ и пригодится, когда нужно проверить штрафы или каршеринг: эти методы принимают номер.

Два дополнения. /plate-history отдаёт список всех госномеров автомобиля от последнего к первому, без дат. Он стоит 1,5 ₽ и тарифицируется только при found >= 2: если номер был один или ни одного, ответ found: 0 бесплатный. Полезно, когда нужно понять, что машина меняла номера, а потому могла менять регион и владельцев. /autopark возвращает номер двигателя по VIN, номеру кузова или шасси за 0,8 ₽, и платно только если номер найден.

Для оценки себестоимости вот базовые цены основных методов, за запрос:

• краткие данные ТС: 1 ₽, расшифровка VIN: 1,4 ₽;
• история регистрации: 12 ₽, ограничения и розыск (Score): 20 ₽;
• реестр залогов: 2,4 ₽, штрафы: 0,9 ₽, ЭПТС: 1 ₽;
• пробег по ЕАИСТО: 3,4 ₽, ОСАГО: 1,5 ₽, такси: 1,8 ₽;
• ДТП по базе ГИБДД: 19 ₽, сервисная история: 26 ₽.

Актуальные значения всегда в prices.json.

Цепочка запросов: от госномера до карточки автомобиля

Главная мысль: не гоняйте дорогие методы на каждую машину. Сначала дешёвая идентификация, потом решение, нужен ли полный отчёт.

Краткие данные ТС за 1 ₽ дают марку, модель, год, мощность, тип и объём двигателя, руль и массу. Расшифровка VIN за 1,4 ₽ показывает поколение, кузов, коробку, привод, страну и завод сборки. Если в объявлении написано одно, а VIN говорит другое (например, заявлен полный привод, а в расшифровке передний), отсев произошёл за рубль с небольшим.

Пример на Python:

import requests

BASE = "https://api.avtovincod.ru"
H = {"Authorization": "Bearer ВАШ_ТОКЕН"}

def get(path, **params):
 r = requests.get(f"{BASE}/{path}", headers=H, params=params, timeout=30)
 return r.json()

plate = "Т000ТТ00"

g = get("gos2vin", plate=plate)
if g.get("success") != 1:
 raise SystemExit("VIN не найден")
vin = g["vin"] # проверьте точное имя поля в схеме метода

brief = get("brief", vin=vin)
decode = get("decode", vin=vin)

# первичный отбор по своим правилам
if brief.get("success") == 1:
 pledge = get("pledge", vin=vin)
 score = get("score", vin=vin)
 # решение по залогам и ограничениям

Имена полей сверяйте со схемой конкретного метода в документации: образец ответа на тестовых значениях покажет структуру без единого списанного рубля.

Логика выбора глубины обычно такая. На входе воронки (заявка, карточка в базе, объявление) вы делаете идентификацию и расшифровку, это 2-3 ₽ на машину. Дальше отбрасываете то, что не проходит по критериям: год, мощность, несовпадение данных. Для оставшихся запрашиваете реестры: залоги, ограничения, пробег. Самые дорогие отчёты, вроде ДТП по базе ГИБДД или сервисной истории, запускаете только для тех машин, по которым реально принимается решение о сделке. Так средний чек проверки заметно падает, а качество решений остаётся прежним.

Набор методов под сценарий бизнеса

Описания методов дублировать не будем, они есть в документации API. Покажу, какие связки работают на практике.

Автосалон и трейд-ин

Основа: история регистрации (периоды владения, число хозяев, характеристики), ограничения и розыск (запреты на регистрационные действия, тип, основание, исполнительное производство), реестр залогов ФНП. Сверху пробег по ЕАИСТО: сопоставьте с одометром на приёмке. Если расхождение большое, подключайте ДТП и объявления о продаже с прошлым пробегом.

Лизинг и страховые

Залоги, ОСАГО (полисы и их история с признаком использования в такси), проверка такси, лизинг и судебные дела арбитража, где упоминается автомобиль. Для андеррайтинга полезна история ОСАГО: цель использования, ограничение по водителям, тип собственника, без персональных данных.

Маркетплейс и доска объявлений

При подаче объявления: расшифровка VIN для сверки с заявленными параметрами, затем объявления о продаже и пробег. Фотографии автомобиля из открытых объявлений помогают заметить подмену. Результат выводите как значок или блок "что известно об автомобиле".

Автопарк и логистика

Штрафы по СТС, пропуска на МКАД (/truck-pass, показывает isActive, зону и срок), РНИС (дата последней навигационной отметки в lastMark) и разрешения КТГ для крупногабаритов, где обязательны оба параметра: permit и plate. Ежедневный прогон по парку выявляет пропуск, который истёк вчера, раньше, чем машина получит штраф.

Production: ошибки, тарификация, асинхронность

Каждый ответ содержит success. Значение 1 - проверка выполнена и тарифицируется, 0 - не выполнена или данных нет, бесплатно. Ошибки приходят в формате {"success":0,"error":"текст","code":"КОД"}:

• 400 - неверный формат параметра (чаще всего кривой VIN);
• 401 - проблема с токеном;
• 402 - не хватает баланса;
• 403 - нет доступа или IP не в списке;
• 429 - превышены лимиты;
• 503 - источник недоступен, не тарифицируется.

Важный нюанс: реестровые проверки (такси, залоги, штрафы, ЭПТС, техосмотр) и /score тарифицируются, если проверка выполнена, даже когда записей нет (found: 0). Чистый результат - тоже результат. Исключения: /autopark и /pros-cons не тарифицируют found: 0, /plate-history тарифицируется только при found >= 2. Пропуска, РНИС и КТГ тарифицируют выполненную проверку и при found: 0. Правило каждого метода смотрите в его разделе "Тарификация".

Длинные методы требуют отдельной обработки. /osago-history отвечает обычно за 15-60 секунд: поставьте таймаут клиента с запасом и не гоняйте его в синхронной цепочке пользовательского запроса. ДТП по базе ГИБДД работает как задача: вы создаёте её запросом, затем опрашиваете результат раз в 30 секунд, до 40 минут. Делайте это фоновым воркером и сохраняйте идентификатор задачи, а пользователю показывайте статус.

Что заложить в код с первого дня:

• ретраи на 503 с паузой: источник временно недоступен, а списания нет, повторять безопасно;
• на 429 - экспоненциальная пауза и очередь вместо цикла без задержек;
• сохранение requestId рядом с результатом: по нему быстрее разбирать спорные случаи с поддержкой;
• чтение X-Balance из заголовков и алерт при падении ниже порога, чтобы не получить 402 посреди рабочего дня;
• валидацию VIN (17 символов, без I, O, Q) до отправки: 400 бесплатна, но зачем лишний круг.

Альтернативы интеграции: MCP и готовые решения

Если сервис строится вокруг ИИ-агента, подключайте MCP-сервер: https://api.avtovincod.ru/mcp, Streamable HTTP, JSON-RPC без сессий, авторизация через Authorization: Bearer или параметр ?token=. Доступно 32 инструмента (например, registration_history, restrictions_wanted, pledge_check, fines_check, osago_check, truck_pass, rnis_check). Вызов тарифицируется как запрос к соответствующему методу.

Для сотрудников, которые не пишут код, в кабинете есть консоль проверки: вводите VIN, номер кузова или госномер и получаете отчёт в читаемом виде. Часто так начинают: первую неделю смотрят отчёты руками, понимают, какие поля нужны, и только потом закладывают интеграцию.

Если нужна встроенная проверка под вашим брендом, интеграция в подбор или CRM для автосалонов, смотрите раздел партнёрство и white-label. Технические вопросы можно задать в поддержку: api@avtovincod.ru или Telegram https://t.me/UspSupport.

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

Проверить авто по VIN через API: сборка отчёта для бизнеса

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

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