Главная → Документация → Проверка ЭПТС

Проверка электронного ПТС

Проверка электронного паспорта транспортного средства (ЭПТС): страна выпуска, тип ТС, утилизационный сбор, статус ограничений и таможенных ограничений, последнее регистрационное действие. Поиск по VIN или номеру ПТС.

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

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

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

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

Эндпоинт

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

Параметр	Описание
vin	VIN, от 11 до 17 символов (латиница без I, O, Q).
pts	Номер ПТС, от 10 до 20 символов. Указывается вместо VIN.
force_refresh=1	Необязательный. Игнорировать кэш.

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

{
  "success": 1,
  "query": { "vin": "XKN0A1000L1000003" },
  "found": 1,
  "status": "done",
  "records": [
    {
      "country": "Россия",
      "type": "Легковой автомобиль",
      "displosal_fee": "оплачен",
      "restrictions_status": "нет ограничений",
      "customs_restrictions_status": "нет ограничений",
      "last_reg_action": "Постановка на регистрационный учёт",
      "production": "2020"
    }
  ]
}

Поиск по заводскому номеру (pin) не поддерживается. Если ЭПТС не найден, ответ приходит с success: 1 и found: 0: проверка выполнена, паспорт в системе отсутствует.

Коды ошибок

HTTP · code	Что означает
400 · VIN_INVALID / PTS_INVALID	Неверный формат VIN или номера ПТС.
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	Превышена частота запросов в минуту. Повторите через минуту.
503 · SERVICE_UNAVAILABLE	Источник временно недоступен. Повторите позже, запрос не тарифицирован.

Пример на cURL

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

Тарификация

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

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

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