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

Реестр залогов (ФНП)

Проверка автомобиля в реестре уведомлений о залоге движимого имущества Федеральной нотариальной палаты: залогодатели и залогодержатели, дата и номер уведомления, история изменений записи. Поиск по VIN, номеру кузова или номеру шасси.

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

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

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

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

Эндпоинт

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

Параметр	Описание
vin	VIN, от 11 до 17 символов (латиница без I, O, Q).
body	Номер кузова, от 4 до 25 символов. Указывается вместо VIN. Синоним: bodyNumber.
chassis	Номер шасси, от 4 до 25 символов. Указывается вместо VIN. Синоним: chassisNumber.
force_refresh=1	Необязательный. Игнорировать кэш.

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

{
  "success": 1,
  "query": { "vin": "SALLMAMH4CA388911" },
  "found": 1,
  "records": [
    {
      "register_date": "2022-03-10",
      "number": "2022-006-123456-789",
      "pledgor_hidden": 0,
      "pledgee_hidden": 0,
      "objects": ["SALLMAMH4CA388911"],
      "pledgors": [ { "type": "individual", "name": "И*** И.И." } ],
      "pledgees": [ { "type": "company", "name": "Банк" } ],
      "history": [
        { "date": "2022-03-10", "type": "Регистрация уведомления", "number": "2022-006-123456-789" }
      ]
    }
  ]
}

Пустой список records при success: 1 означает, что реестр отработал и залогов по автомобилю не найдено. Служебные поля поставщика в ответ не попадают. Проверять один и тот же автомобиль полезно по VIN и по номеру кузова: залог мог быть зарегистрирован по любому из идентификаторов.

Коды ошибок

HTTP · code	Что означает
400 · VIN_INVALID / BODY_INVALID / CHASSIS_INVALID	Неверный формат идентификатора.
400 · INPUT_REQUIRED	Не указан ни VIN, ни номер кузова, ни номер шасси.
503 · PROVIDER_FAIL	Проверка не выполнена ни одним источником, запрос не тарифицирован.
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/pledge?vin=SALLMAMH4CA388911" \\
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

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

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

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