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

Интеграция API

Проверить машину по номеру через API: как получить данные по госномеру в своём сервисе

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

Чтобы проверить машину по номеру в своём сервисе, отправьте госномер в методы API АвтоВинКод, которые принимают plate: /brief, /osago, /probeg, /taxi, /sharing, /offers, /nomerogram. Для методов только по VIN сначала получите VIN через /gos2vin и дальше работайте уже с ним. Один Bearer-токен, ответы в JSON, списание только за выполненную проверку.

Ниже - как это выглядит на практике: что принимает номер, что нет, как собрать из нескольких методов одну карточку и не наступить на типичные грабли. Общий сценарий мы уже разбирали в материале сценарий проверки по номеру для бизнеса, а про салоны и площадки - в статье проверка по госномеру для автосалона и площадки. Здесь упор на техническую сторону.

Что можно узнать по одному госномеру через API

Методы делятся на две группы. Первая принимает plate напрямую:

/brief - краткая карточка: марка, модель, год, мощность;
/osago и /osago-history - полисы и история полисов;
/probeg - диагностические карты ЕАИСТО и пробег;
/taxi - разрешения на работу в такси;
/sharing - использование в каршеринге;
/offers - история объявлений о продаже;
/nomerogram - фотографии из открытых объявлений;
/lawsuits - арбитражные дела;
/invalid-reg - реестр инвалидов;
/europrotocol - ДТП по европротоколу;
/gos2vin - VIN по госномеру.

Вторая группа работает только по VIN (или номеру кузова): история регистрации, ограничения и розыск (/score), залоги ФНП, ЭПТС, таможня, сервисная история, лизинг. Для них номер превращается в VIN одним запросом, и дальше всё идёт по обычной схеме.

Чем это отличается от сайтов, где человек вводит номер руками? Тем, что вы убираете человека из цепочки. Менеджер выкупа вставляет номер в карточку заявки в CRM, а справа уже подгружены марка, полисы, пробег и признак такси. Форма на сайте отправляет номер в ваш бэкенд, бэкенд дёргает API и решает, показывать ли клиенту предложение. Никаких копирований между вкладками.

Шаг 1. Подключение и тест без трат

Регистрация в кабинете avtovincod.ru/lk занимает минуту, токен выдаётся сразу. Договор не нужен, пополнение от 100 рублей банковской картой (чек уходит на email). Юрлицам доступен счёт с актом и актом сверки в конце месяца.

Прежде чем тратить деньги, прогоните интеграцию на тестовых значениях: госномер Т000ТТ00 и VIN X7TEST00000000001. Они бесплатны, подробности - в описании на странице тестовый режим. Для боевых запросов токен передаётся в заголовке:

Authorization: Bearer ВАШ_ТОКЕН

Полный перечень методов и параметров лежит в документации API АвтоВинКод.

Шаг 2. Быстрая карточка по номеру: /brief

Это самый дешёвый способ понять, что за машина перед вами. Метод краткие данные ТС стоит 1 рубль:

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

В ответе приходят марка, модель, год, мощность, тип и объём двигателя, расположение руля, масса. Точные имена полей сверяйте со схемой в документации, не гадайте по примеру.

Когда этого хватает? В форме заявки на выкуп: клиент ввёл номер, вы подставили марку, модель и год, он только подтверждает. В предскоринге лизинга или страховки: отсекли заведомо неподходящие машины за рубль, а полный отчёт заказываете только по тем, что прошли. Деньги экономятся именно на этом фильтре.

Шаг 3. Получить VIN по госномеру: /gos2vin

Метод VIN по госномеру стоит 8 рублей:

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

Возвращаются VIN, номер кузова или шасси, данные СТС, марка, модель, год, мощность и признак такси. Дальше схема простая:

получили номер от пользователя;
проверили в своей базе, нет ли уже связки номер - VIN;
если нет, вызвали /gos2vin и сохранили связку вместе с датой;
все последующие VIN-методы (/score, /pledge, /elpts, /lizing и другие) вызываете по VIN.

Кэш окупается быстро: те же 8 рублей не придётся платить при повторной проверке той же машины. Подробнее про встраивание в учётную систему - в статье VIN по госномеру в CRM.

Для обратной сверки есть /vin2gos: по VIN возвращает действующий госномер. Если пользователь прислал и номер, и VIN, прогоните оба направления и убедитесь, что они указывают на одну машину.

Шаг 4. Проверки, которые работают прямо по номеру

Метод	Параметр	Цена, руб.	Зачем бизнесу
/brief	plate	1	Карточка для формы заявки и предскоринга
/osago	plate	1,5	Страховая, статус и срок полиса
/probeg	plate	3,5	Диагностические карты ЕАИСТО, пробег
/taxi	plate	1,8	Работа в такси, разрешения
/sharing	plate	5,4	Следы каршеринга
/offers	plate	1,5	Прошлые объявления: цена, пробег, город
/nomerogram	plate	1,7	Снимки из открытых объявлений
/lawsuits	plate	3	Арбитраж: споры, лизинг, банкротство
/europrotocol	plate	5,5	ДТП без вызова ГИБДД
/osago-history	plate	см. тариф в кабинете	Все полисы за годы, цель использования

Несколько практических наблюдений. Полисы ОСАГО по госномеру показывают страховую, серию и номер, статус и срок. А вот сверка истории техосмотра и пробега с пробегом из объявления из /offers быстро выявляет скрутку: если в 2022 году диагностическая карта фиксировала 140 тысяч, а сейчас продавец говорит 90, разговор окончен. Фотографии автомобиля по номеру нужны оценщику, когда клиент прислал три мутных снимка.

Отдельно про историю номеров. Машина могла сменить госномер при переезде или замене знаков, и тогда проверка только по текущему номеру покажет не всё. История госномеров (метод /plate-history, по VIN или номеру кузова) отдаёт список номеров от последнего к первому, без дат. Стоит 1,5 рубля, и списание только если найдено больше одного номера (found ≥ 2). Один номер или ни одного - found: 0, бесплатно.

Шаг 5. Пример кода: оркестрация нескольких методов

Запросы по номеру независимы, поэтому гоните их параллельно с жёсткими таймаутами. Пример на Python:

import asyncio, httpx

BASE = "https://api.avtovincod.ru"
HEAD = {"Authorization": "Bearer ВАШ_ТОКЕН"}
METHODS = ["brief", "osago", "probeg", "taxi", "sharing", "offers"]

async def call(client, method, plate):
 for attempt in range(3):
 try:
 r = await client.get(f"{BASE}/{method}",
 params={"plate": plate}, timeout=20)
 if r.status_code == 200:
 return method, r.json()
 except httpx.RequestError:
 pass
 await asyncio.sleep(2 * (attempt + 1))
 return method, {"error": "unavailable"}

async def check(plate):
 async with httpx.AsyncClient(headers=HEAD) as c:
 res = await asyncio.gather(*[call(c, m, plate) for m in METHODS])
 return {"plate": plate, **dict(res)}

print(asyncio.run(check("Т000ТТ00")))

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

Теперь про долгие методы. /osago-history отвечает обычно за 15-60 секунд, /accidents-rt вообще работает через задачу с опросом раз в 30 секунд. Не ждите их в основном запросе. Верните интерфейсу быструю часть (brief, osago, taxi), а тяжёлые методы запустите в фоне и подтяните результат через очередь или веб-сокет. Оператор уже читает карточку, пока история полисов догружается.

Сценарии: где встроить проверку по номеру

Выкуп и трейд-ин. Клиент звонит и диктует только номер. Оператор вводит его в CRM, система вызывает /brief, /osago, /taxi, /gos2vin, сохраняет VIN и по нему запускает остальное. К концу разговора у оценщика есть марка, признак такси и статус полиса.

Доска объявлений. Продавец загружает фото, а номер на них виден. Метод /photo-plate распознаёт госномер, марку и цвет прямо с фотографии (0,1 рубля), так что поле номера можно заполнить автоматически. Перед публикацией /plate-hide закрывает номера размытием, мозаикой, заливкой или вашим логотипом (0,09 рубля за фото). Обе операции стыкуются в один конвейер загрузки.

Страховые, автопарки, лизинг. Тут обычно не один номер, а список из сотен. Сценарий тот же, только в цикле, с ограничением параллелизма. Если код писать не хочется, посмотрите массовую проверку авто, там же есть мониторинг.

Сколько это стоит и как считать экономику

Возьмём типовой набор для заявки на выкуп: /brief 1 + /osago 1,5 + /probeg 3,5 + /gos2vin 8 = 14 рублей. Добавим /taxi (1,8) и /offers (1,5) - получится 17,3 рубля за машину. Если из десяти заявок реальных сделок две, то стоимость проверки на сделку - около 87 рублей. Дорого или дёшево, решает ваша маржа, но считать теперь есть что.

Порядок вызовов влияет на расходы. Дешёвый /brief ставьте первым как фильтр, дорогой /gos2vin и все VIN-методы - после того, как машина прошла первичный отбор.

Платно только за результат: ряд методов не списывает деньги при пустом ответе. Например, /plate-history берёт плату лишь при found ≥ 2, /europrotocol - только когда найдены записи, /gibdd-archive - только если найдены периоды владения. Ошибки и сбои источника бесплатны всегда. Депозит действует 90 дней, поэтому пополняйте под реальный поток, а не на год вперёд. Юрлицам подойдёт оплата по счёту с актом.

Типичные ошибки интеграции

Формат номера. Передавайте кириллицу в верхнем регистре, без пробелов: А123ВС77. Частая беда - латинская A вместо русской А, внешне они неотличимы. Нормализуйте ввод на своей стороне: заменяйте латинские буквы-двойники (A, B, C, E, H, K, M, O, P, T, X, Y) на кириллические, обрезайте пробелы, приводите регистр. Сломанный номер даст пустой ответ, и вы потратите время на поиск причины.

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

Лишние данные. Не храните сырые ответы дольше, чем нужно для работы. Достаточно связки номер - VIN, даты проверки и тех полей, которые используете в решении. Кэшируйте именно связку: она редко меняется, а экономит 8 рублей на каждом повторе. Результаты динамичных методов (полисы, штрафы, объявления) кэшируйте коротко или не кэшируйте совсем.

Для начала возьмите тестовый номер Т000ТТ00, прогоните через все методы из таблицы и убедитесь, что ваш парсер переживает и полные ответы, и пустые. Потом пополните баланс на 100 рублей и проверьте первую реальную машину.

Частые вопросы

Как проверить машину по номеру через API, если нужен только госномер?

Отправьте номер в методы с параметром plate: /brief, /osago, /probeg, /taxi, /sharing, /offers, /nomerogram и другие. Для методов, которым нужен VIN, сначала вызовите /gos2vin, сохраните VIN и дальше используйте его. Авторизация - заголовок Authorization: Bearer с вашим токеном.

Можно ли получить VIN по госномеру программно и сколько это стоит?

Да, метод /gos2vin (GET /gos2vin?plate=) возвращает VIN, номер кузова или шасси, данные СТС, марку, модель, год, мощность и признак такси. Стоимость - 8 рублей за запрос. Связку номер - VIN лучше сохранить у себя, чтобы не платить повторно.

Какие методы АвтоВинКод принимают госномер без VIN?

Напрямую по plate работают /brief, /osago, /osago-history, /probeg, /taxi, /sharing, /offers, /nomerogram, /lawsuits, /invalid-reg, /europrotocol и /gos2vin. Методы вроде /score, /pledge, /elpts, /lizing требуют VIN.

Как протестировать запросы по госномеру бесплатно?

Используйте тестовые значения: госномер Т000ТТ00 и VIN X7TEST00000000001. Запросы с ними не списывают деньги. Токен выдаётся сразу после регистрации в кабинете avtovincod.ru/lk, пополнять баланс для тестов не обязательно.

Что делать, если по номеру ничего не найдено: списываются ли деньги?

Ошибки и сбои источника не тарифицируются. Часть методов также не списывает деньги при пустом результате: /plate-history берёт плату только при found 2 и больше, /europrotocol - только если найдены записи. Если ответ пустой, сначала проверьте формат номера: кириллица, верхний регистр, без пробелов.

Как проверить историю госномера и смену номеров у автомобиля?

Вызовите /plate-history по VIN или номеру кузова. Метод вернёт список госномеров от последнего к первому, без дат. Стоит 1,5 рубля, списание только если найдено два номера и больше (found ≥ 2).

Можно ли проверять сразу список номеров?

Да. Либо запускайте запросы в цикле с ограничением параллелизма и таймаутами, как в примере кода выше, либо используйте готовое решение на странице массовой проверки авто. Для больших списков заранее пополните депозит с учётом срока его действия - 90 дней.

Проверка автомобилей через API

Без договора и долгих согласований: пополните баланс от 100 ₽ и проверяйте реальные машины. Тестовые значения бесплатно, документация с примерами на популярных языках.

Получить токен Документация API