Главная → Документация → Проверка лизинга
Проверка лизинга по VIN
Поиск записей о передаче автомобиля в лизинг: лизингополучатель, даты начала и окончания договора и дополнительная информация. Незавершённый лизинг может означать обременение — автомобиль принадлежит лизинговой компании.
Аутентификация
Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:
Authorization: Bearer ВАШ_ТОКЕН
Эндпоинт
GET https://api.avtovincod.ru/lizing?vin=XTA210990Y2696785
Authorization: Bearer ВАШ_ТОКЕН
| Параметр | Описание |
|---|---|
| vin | VIN, строго 17 символов (латиница без I, O, Q). Кириллические двойники нормализуются автоматически. |
| force_refresh=1 | Необязательный. Игнорировать кэш. |
Пример успешного ответа
{
"success": 1,
"query": { "vin": "9BSR4X20003931904" },
"isLeasing": true,
"found": 2,
"records": [
{
"lessee": "Юридическое лицо",
"dateStart": "2024-12-23",
"dateEnd": "2029-06-24",
"contract": { "number": "2390/24-КЛС", "date": "2024-12-23" },
"subject": "Грузовой транспорт",
"isSublease": false,
"lessors": [ { "name": "Сведения скрыты в соответствии с ПП РФ №5", "inn": null, "ogrn": null } ],
"lessees": [ { "name": "ООО «МФС»", "inn": "7810736754", "ogrn": "1187847228579" } ]
},
{
"lessee": "ИП",
"dateStart": "2023-08-08",
"dateEnd": "2029-05-31",
"contract": { "number": "2780039514", "date": "2023-07-06" },
"subject": "SCANIA R400LA4X2HLA",
"isSublease": false,
"lessors": [ { "name": "ООО «КОНТРОЛ ЛИЗИНГ»", "inn": "7805485840", "ogrn": "1097847051620" } ],
"lessees": [ { "name": "КАРАКУЛИН РОМАН ДМИТРИЕВИЧ", "inn": "740703591552", "ogrn": "323745600057426" } ]
}
]
}
Каждый договор — структурная запись: тип лизингополучателя (lessee), срок, номер и дата договора (contract), предмет (subject), признак сублизинга и стороны с ИНН/ОГРН (lessors/lessees; имена могут быть скрыты по ПП РФ №5). Обратите внимание на dateEnd: дата в будущем или её отсутствие — договор может действовать (обременение). isLeasing: false при success: 1 — проверка выполнена, договоров нет.
Коды ошибок
| HTTP · code | Что означает |
|---|---|
| 400 · BAD_VIN | Неверный формат VIN (нужно строго 17 символов). |
| 400 · INPUT_REQUIRED | VIN не указан. |
| 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 | Превышена частота запросов в минуту. Повторите через минуту. |
| 200 · PROVIDER_FAIL (success: 0) | Источник не смог выполнить проверку. Запрос не тарифицирован, повторите позже. |
| 503 · SERVICE_UNAVAILABLE | Источник временно недоступен. Повторите позже, запрос не тарифицирован. |
Пример на cURL
curl -s --max-time 60 "https://api.avtovincod.ru/lizing?vin=XTA210990Y2696785" \
-H "Authorization: Bearer ВАШ_ТОКЕН"
Тарификация
Списание происходит, когда проверка выполнена (success: 1), даже если договоров лизинга не найдено. Ошибки, недоступность источника и повторы из кэша не тарифицируются. Актуальная цена, баланс и статистика запросов с телами ответов доступны в личном кабинете.
Попробуйте прямо сейчас. Регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.
Создать аккаунт