Главная → Блог → Проверка авто по VIN через API: какие данные получить и как собрать отчёт для бизнеса

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

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

Единого запроса "весь отчёт" нет: отчёт по VIN собирается из нескольких методов API, каждый отвечает за свой блок (регистрация, ограничения, залог, ОСАГО, пробег, ДТП и др.). Вы выбираете набор под свой процесс, вызываете методы по одному VIN одним Bearer-токеном и объединяете JSON в своей системе. Оплата идёт только за выполненные проверки, а тестовый VIN X7TEST00000000001 позволяет отладить всю сборку бесплатно.

Дальше - какие блоки брать, сколько это стоит, как обрабатывать ответы и где легко потратить лишнее. Общий обзор сервиса есть на странице API проверки авто по VIN и номеру кузова, а полный перечень методов - в документации всех методов.

Что значит "проверить авто по вину" для бизнеса

Для частного покупателя проверка - это одна машина и один просмотр страницы. Для бизнеса это поток. Менеджер автосалона вводит VIN в CRM и ждёт, что карточка сделки сама заполнится данными. Оценщик трейд-ина хочет видеть цифры до того, как клиент уедет с площадки. Скоринг лизинговой компании прогоняет сотни заявок в день. Доска объявлений проверяет VIN при публикации и ставит метку "проверено".

Во всех этих случаях проверка должна быть автоматической, предсказуемой по стоимости и встроенной в ваш процесс. Разовая проверка в консоли кабинета для этого не подходит: консоль удобна, когда нужно один раз посмотреть машину в читаемом виде по VIN, номеру кузова или госномеру, но не когда нужен поток запросов и машинный ответ. Для потока есть REST API: GET-запрос, JSON в ответе, один токен на все методы.

Почему именно блоки, а не один вызов? Потому что у разных процессов разный состав отчёта. Салону на выкупе нужны пробег и ДТП, маркетплейсу - фото и объявления, автопарку - пропуска и телеметрия. Платить за всё сразу в каждом случае было бы расточительно, поэтому набор вы определяете сами. Более общий взгляд на интеграцию - в материале API ГИБДД для бизнеса.

Базовый набор: что проверять почти всегда

Есть пять блоков, которые попадают в отчёт в большинстве сценариев.

Краткие данные и расшифровка VIN

Краткие данные ТС (/brief, 1 ₽) возвращают марку, модель, год, мощность, тип и объём двигателя, руль и массу. Расшифровка VIN (/decode, 1,4 ₽) показывает, что зашифровано в самом номере: поколение, кузов, двигатель, коробку, привод, страну и завод сборки. Вместе они стоят 2,4 ₽ и дают быструю сверку: совпадает ли заявленное в объявлении или анкете с тем, что "зашито" в VIN. Расхождение по мощности или типу кузова - повод остановиться, не потратив ни рубля на дорогие методы.

История регистрации

История регистрации (/vin, 12 ₽): периоды владения, характеристики, данные ПТС и СТС. Число владельцев и сроки владения хорошо отражают судьбу машины. Три владельца за два года - это сигнал, который стоит учесть в цене.

Ограничения и розыск

Ограничения и розыск (Score) (/score, 20 ₽): запреты на регистрационные действия с типом, основанием, регионом и номером исполнительного производства, розыск и периоды владения. Обратите внимание на поле found: 1 означает, что данные есть, 0 - что VIN не найден в базе ГИБДД. Метод дорогой, поэтому его место не в начале цепочки (об этом ниже).

Залоги и штрафы

Реестр залогов (/pledge, 2,4 ₽) отвечает, действует залог или прекращён (status, active_count), и показывает залогодателей, залогодержателей и историю изменений уведомления. Штрафы ГИБДД (/fines, 0,9 ₽) ищутся по СТС, водительскому удостоверению или УИН и возвращают сумму, дату, скидку и статус оплаты. Для выкупа неоплаченные штрафы - это прямые деньги, которые придётся вычесть или закрыть.

Базовый набор из пяти блоков (brief, decode, vin, score, pledge) обходится в 12 + 20 + 2,4 + 1 + 1,4 = 36,8 ₽, а со штрафами - 37,7 ₽.

Расширенный набор под сценарий

Дальше набор зависит от того, кто вы и зачем проверяете.

Выкуп и трейд-ин. Здесь важна реальная картина состояния и справедливая цена. Берут историю техосмотра и пробег (/probeg, 3,4 ₽): диагностические карты ЕАИСТО с зафиксированным пробегом, по которым ловится скрутка. Добавляют историю полисов ОСАГО (/osago-history, актуальную цену смотрите в prices.json): страховые, периоды, цель использования, в том числе такси. Для ДТП - ДТП по базе ГИБДД (/accidents-rt, 19 ₽), происшествия с 2015 года с повреждениями. Для цены - /price (0,5 ₽) и /offers (1,5 ₽): сверка пробега и цены по прошлым продажам. И данные о растаможке (/customs, 1 ₽), если машина могла быть ввезена из-за рубежа.

Лизинг и страховые. Тут смотрят юридическую чистоту и профиль использования: проверка лизинга (/lizing, 2,2 ₽), /lawsuits (3 ₽) по арбитражным делам с упоминанием машины, /taxi (1,8 ₽), проверка каршеринга (/sharing, 5,4 ₽) и /elpts (1 ₽) для электронного ПТС с утилизационным сбором и таможенными ограничениями. Такси и каршеринг резко меняют риск-профиль: износ и аварийность у таких машин выше.

Маркетплейсы и доски объявлений. Основа - /decode для автозаполнения карточки по VIN, /nomerogram (1,7 ₽) со ссылками на снимки из открытых объявлений, /offers для истории цены и пробега и /recalls (0,8 ₽) для отзывных кампаний. Это дёшево, поэтому проверку можно делать на каждой публикации.

Автопарки и логистика. Для грузовых: /rnis (1,3 ₽) показывает, есть ли машина в навигационной системе Москвы и когда была последняя отметка (lastMark, lastMarkDaysAgo), /truck-pass (1,3 ₽) - действует ли пропуск на МКАД, ТТК или Садовое кольцо (isActive), /ktg-permit (1,25 ₽) - сверку разрешения на крупногабарит с машиной; здесь обязательны оба параметра, permit и plate.

Суммы посчитаны по базовым тарифам; точные тарифы обновляются в prices.json, а итоговую стоимость каждого запроса вы увидите в блоке billing ответа.

Если на входе госномер, а не VIN

Клиент часто присылает фото машины или называет только номер. Тогда цепочка начинается с VIN по госномеру (/gos2vin?plate=, 8 ₽): в ответе VIN, номер кузова или шасси, СТС, марка, модель, год, мощность и признак такси. Дальше все остальные методы вызываются уже по полученному VIN. Часть методов (/probeg, /osago, /taxi, /sharing, /nomerogram, /brief) принимает и госномер напрямую, и там лишний шаг можно не делать.

Обратная задача тоже решается. /vin2gos (6 ₽) отдаёт действующий госномер по VIN, а /plate-history (1,5 ₽) - список всех госномеров от последнего к первому, без дат. История номеров полезна, чтобы найти регионы, где машина жила, и связать её с объявлениями прошлых лет. Деньги списываются только при found >= 2.

Для авто без VIN, например японских, есть номер кузова: /body?body= для истории регистрации и /score-body?body= для ограничений и розыска. Параметр body принимают также залоги, пробег, ОСАГО и ДТП по базе ГИБДД (/accidents-rt); архивный /accidents работает только по vin.

Пример сборки отчёта

Один запрос выглядит так:

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

Ответ приходит в JSON. Если проверка выполнена, там "success": 1 и блок billing с полями charged, currency, balance, requestId. Те же значения дублируются в заголовках X-Charged, X-Balance, X-Request-Id. Нет блока billing - запрос не списан.

Теперь сборка на Python с параллельными вызовами:

import requests
from concurrent.futures import ThreadPoolExecutor

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

METHODS = ["brief", "decode", "vin", "score", "pledge", "probeg"]

def call(method):
 try:
 r = requests.get(f"{BASE}/{method}", params={"vin": VIN},
 headers=HEAD, timeout=60)
 return method, r.status_code, r.json()
 except Exception as e:
 return method, 0, {"success": 0, "error": str(e)}

report = {"vin": VIN, "blocks": {}, "errors": {}, "cost": 0.0}

with ThreadPoolExecutor(max_workers=6) as pool:
 for method, status, data in pool.map(call, METHODS):
 if data.get("success") == 1:
 report["blocks"][method] = data
 report["cost"] += data.get("billing", {}).get("charged", 0)
 else:
 report["errors"][method] = {
 "http": status,
 "code": data.get("code"),
 "error": data.get("error"),
 }

Что здесь важно. Во-первых, success: 0 - это не обязательно сбой: проверка не выполнена или данных нет, и это бесплатно. Во-вторых, у реестровых методов нужно смотреть ещё и found: ответ с success: 1 и found: 0 означает "проверили, записей нет", и такая проверка тарифицируется. В-третьих, суммируйте billing.charged по каждому запросу, чтобы стоимость отчёта лежала рядом с самим отчётом.

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

Как не переплатить и не сломать сценарий

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

Ошибки бесплатны. Сбой источника (503) и ошибки запроса не тарифицируются, поэтому повтор после 503 с паузой безопасен для бюджета. Зато повторный успешный запрос по тому же VIN спишется снова. Кэшируйте результат на своей стороне: храните блоки по VIN с датой и не дёргайте тот же метод, пока данные не устарели. Штрафы и пробег меняются быстро, а характеристики и расшифровка VIN - нет.

Стройте воронку. Не запускайте всё подряд. Сначала дешёвые методы: /brief и /decode за 2,4 ₽ отсеивают несовпадения по заявленным характеристикам. Потом /pledge (2,4 ₽): он работает по VIN, и залог часто снимает вопрос о сделке. Штрафы (/fines, 0,9 ₽) проверяются по СТС, поэтому ставьте их после шага, где вы получили номер СТС: из /vin, /gos2vin или /vin2gos. И только если машина прошла фильтр, идут дорогие: /score (20 ₽), /service (26 ₽, сервисная история), /accidents-rt (19 ₽). Если из 100 заявок 40 отсеиваются на втором шаге, вы не платите за 40 запросов по 20 ₽, то есть экономите 800 ₽ на каждой сотне.

Обрабатывайте коды ошибок. Формат единый: {"success":0,"error":"текст","code":"КОД"}.

• 400 - неверный формат VIN или параметра: исправьте входные данные, повтор бессмыслен.
• 401 - проблема с токеном: проверьте заголовок Authorization.
• 402 - не хватает баланса: пополните депозит и поставьте алерт на низкий остаток.
• 403 - нет доступа или IP не в списке разрешённых.
• 429 - превышены лимиты: добавьте очередь и экспоненциальную паузу.
• 503 - источник недоступен: повторите позже, списания нет.

Старт за 15 минут

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

Отлаживать сборку можно без расходов. Для этого есть тестовые значения: VIN X7TEST00000000001, госномер Т000ТТ00, номер кузова TEST-0000001. Любой метод отвечает образцом по своей схеме, бесплатно, с полем "testMode": true. Токен нужен и для тестов. Прогоните через них весь пайплайн, включая ветки ошибок и асинхронный /accidents-rt, и только потом пополняйте баланс.

Если вы строите ИИ-агента, подключите MCP-сервер (https://api.avtovincod.ru/mcp): 32 инструмента, вызов тарифицируется как запрос к соответствующему методу. Бесплатной проверки реальных машин по VIN нет ни в API, ни в кабинете. Для разового просмотра без программирования есть консоль проверки в кабинете: она показывает данные в читаемом виде, но проверки в ней тоже списываются с баланса.

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

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

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

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