Главная → Документация → Score: ограничения и розыск

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

Запреты на регистрационные действия (тип, инициатор, регион, основание), розыск, статус записи, теххарактеристики и периоды владения — по VIN или номеру кузова.

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

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

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

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

Эндпоинты

Проверка по VIN

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

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

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

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

Обработка асинхронная на стороне источника: закладывайте таймаут клиента 60 секунд и не разрывайте соединение раньше. Цена, лимиты и кэш у обоих эндпоинтов общие.

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

{
  "success": 1,
  "record": { "model": "KIA RIO", "year": "2019", "recordStatus": "действующая",
    "ownershipPeriods": [ { "personType": "Физическое лицо", "from": "2019-09-10", "to": null } ] },
  "restrictions": [
    { "type": "Запрет на регистрационные действия",
      "dateAdded": "2025-11-02", "initiator": "Судебный пристав",
      "region": "Московская область", "reason": "Документ: 123456789/5077" }
  ],
  "searches": [],
  "status": { "restricted": true, "wanted": false }
}

Для решения используйте блок status как итоговые флаги, детали — в restrictions и searches (пустой массив = чисто). Данные не найдены — {"success": 0} (бесплатно).

Коды ошибок

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

Пример на cURL

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

Тарификация

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

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

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