Главная → Документация → VIN по госномеру

VIN по госномеру

Определение VIN, номера кузова/шасси и данных СТС по госномеру; дополнительно — марка, модель, год, мощность, категория и признак работы в такси.

Хост api.avtovincod.ru Метод GET Формат JSON Авторизация Bearer Ответ до 45 сек

Аутентификация

Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:

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

Эндпоинт

GET https://api.avtovincod.ru/gos2vin?plate=А007ОК178
Authorization: Bearer ВАШ_ТОКЕН

Параметр	Описание
plate	Обязательный. Госномер: русские буквы АВЕКМНОРСТУХ и цифры, 6–9 символов. Латиница нормализуется автоматически, пробелы и дефисы игнорируются.
force_refresh=1	Необязательный. Игнорировать кэш.

Пример успешного ответа

{
  "success": 1,
  "licensePlate": "А007ОК178",
  "vin": "WV2ZZZ7HZEH045284",
  "bodyNumber": null,
  "chassisNumber": null,
  "sts": { "series": "9908", "number": "725698", "date": "2019-07-25" },
  "brand": "Volkswagen", "model": "Transporter", "year": 2014,
  "enginePower": 106, "vehicleCode": "B",
  "isTaxi": false, "status": "done"
}

У ТС без VIN заполняется bodyNumber (при его отсутствии в учёте — подставляется номер шасси). Автомобиль не найден — {"success": 0, "status": "not_found"} (бесплатно). Найденный VIN удобно сразу передавать в API истории регистрации и Score — токен общий.

Коды ошибок

HTTP · code	Что означает
400 · PLATE_INVALID	Неверный формат госномера.
403 · NOT_ALLOWED / API_DISABLED	API не подключён для токена или временно отключён — запросите доступ в кабинете.
401 · NO_TOKEN / TOKEN_INVALID	Токен не передан, неверен или деактивирован — возьмите актуальный в кабинете.
402 · INSUFFICIENT_BALANCE	Недостаточно средств — пополните баланс в кабинете (раздел «Платежи»).
403 · IP_NOT_ALLOWED	IP не входит в ваш белый список (если он настроен).
429 · RATE_LIMIT / RATE_LIMIT_IP	Превышена частота запросов в минуту — повторите через минуту.
503 · SERVICE_UNAVAILABLE	Источник временно недоступен — повторите позже, запрос не тарифицирован.

Пример на cURL

curl -s --max-time 60 "https://api.avtovincod.ru/gos2vin?plate=А007ОК178" \\
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

Списание — только когда найден госномер и хотя бы один идентификатор ТС: VIN или номер кузова. Ответ «данные не найдены» (success: 0), ошибки и повторы из кэша не тарифицируются. Актуальная цена, баланс и вся статистика запросов с телами ответов — в личном кабинете.

Попробуйте прямо сейчас — регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.

Создать аккаунт