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

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

Периоды владения, технические характеристики, данные ПТС и СТС — по VIN (17 символов) или, для машин без VIN (например, японских), по номеру кузова.

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

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

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

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

Эндпоинты

Проверка по VIN

GET https://api.avtovincod.ru/vin?vin=Z94C251BBLR069765
Authorization: Bearer ВАШ_ТОКЕН

Проверка по номеру кузова

GET https://api.avtovincod.ru/body?body=DY3W340918
Authorization: Bearer ВАШ_ТОКЕН

Параметр	Описание
vin	Обязательный для /vin. 17 символов: латиница A–Z (без I, O, Q) и цифры; кириллические двойники и регистр нормализуются автоматически.
body	Обязательный для /body. Номер кузова ТС без VIN.
force_refresh=1	Необязательный. Игнорировать кэш (тарифицируется как обычный запрос).

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

{
  "success": 1,
  "record": {
    "vin": "Z94C251BBLR069765",
    "regNumber": "В661ЕН180",
    "sts": { "num": "9967088732", "date": "2026-03-03" },
    "pts": { "num": "80РС422014", "date": "2026-03-03" },
    "model": "KIA RIO", "year": "2019", "color": "Белый",
    "engineVolume": "1591", "powerHp": "123.0",
    "category": "B", "recordStatus": "действующая",
    "ownershipPeriods": [
      { "personType": "Физическое лицо", "from": "2019-09-10", "to": null }
    ]
  }
}

ownershipPeriods — все периоды владения по порядку; "to": null — текущий владелец. Данные не найдены — {"success": 0} (бесплатно).

Коды ошибок

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

Пример на cURL

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

Тарификация

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

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

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