API для проверки автомобилей

Отчёты «Автотека» и JSON, залоги, ФССП, такси, ЭПТС и расшифровка VIN — одним REST API. Войдите по email, выпустите токен и сразу пробуйте на бесплатном тестовом ключе.

Токен за минуту, без договора
Тестовый ключ бесплатно
Оплата картой и СБП
Деньги списываются только за успешный ответ

Войти и получить токен Документация

Кабинет партнёра

Ключи, пополнение, история запросов и операций, привязка Telegram. Вход — кодом на email, пароль не нужен.

Загружаем кабинет…

Быстрый старт

Базовый адрес: https://proverka-vin.ru/api. Ответы — JSON, кодировка UTF-8.

Войдите в кабинет по email и выпустите тестовый ключ pv_test_… — он бесплатный и отдаёт демо-данные в боевом формате.
Подключите интеграцию: ключ передаётся только в заголовке Authorization: Bearer <токен> (или X-Api-Key).
Выпустите боевой ключ pv_live_… и пополните баланс в кабинете — отчётами или рублями для методов.
Делайте запросы. Храните токен на сервере, не в браузере и не в мобильном приложении.

curl -s https://proverka-vin.ru/api/v1/me \
  -H "Authorization: Bearer pv_test_ВАШ_ТОКЕН"

Отчёты

Асинхронно: создаёте отчёт, затем опрашиваете статус раз в 10–20 секунд. Обычно готово за 1–5 минут.

POST `/v1/reports`

Отчёт «Автотека». Тело: {"query": "…"} — VIN, госномер или ссылка на объявление Авито. Списывает 1 отчёт (149 ₽).

curl -s -X POST https://proverka-vin.ru/api/v1/reports \
  -H "Authorization: Bearer pv_live_ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"query":"XTA210990Y2450977"}'

{
  "ok": true,
  "report": {
    "id": "c7a1…",
    "product": "autoteka",
    "status": "processing",
    "pollUrl": "https://proverka-vin.ru/api/v1/reports/c7a1…"
  },
  "creditsLeft": 49
}

POST `/v1/reports/json`

Структурированный JSON-отчёт: регистрации, ДТП, залоги, объявления. Тело: {"vin": "…"} или {"plate": "…"}. Списывает 1 JSON-отчёт (49 ₽).

curl -s -X POST https://proverka-vin.ru/api/v1/reports/json \
  -H "Authorization: Bearer pv_live_ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"vin":"XTA210990Y2450977"}'

GET `/v1/reports/{id}`

Статус отчёта: processing → delivered (Автотека — reportUrl, JSON — data) или failed (отчёт вернётся на баланс). Видны только отчёты своего ключа.

curl -s https://proverka-vin.ru/api/v1/reports/REPORT_ID \
  -H "Authorization: Bearer pv_live_ВАШ_ТОКЕН"

Методы

Мгновенные проверки с оплатой с рублёвого баланса. Списание — только при успешном ответе. Машиночитаемый прайс: GET https://proverka-vin.ru/api/v1/methods.

Получение информации об ЭПТС

0,64 ₽

POST /v1/methods/elpts

Поле	Что передать	Обязательно
`vin`	VIN, 17 символов. Латиница и цифры, без I, O и Q.	да

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/elpts \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"vin":"XTA211440Y5123456"}'

{
  "ok": true,
  "sandbox": false,
  "method": "elpts",
  "priceRub": 0.64,
  "charged": true,
  "balanceRub": 999.36,
  "result": {
    "found": false,
    "vin": "XTA211440Y5123456",
    "status": "Сведения о паспорте не найдены в системе",
    "letter": ""
  }
}

Расшифровка VIN

0,88 ₽

POST /v1/methods/vindecode

Поле	Что передать	Обязательно
`vin`	VIN, 17 символов. Латиница и цифры, без I, O и Q.	да

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/vindecode \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"vin":"XTA211440Y5123456"}'

{
  "ok": true,
  "sandbox": false,
  "method": "vindecode",
  "priceRub": 0.88,
  "charged": true,
  "balanceRub": 999.12,
  "result": {
    "vin": "XTA211440Y5123456",
    "wmi": "XTA",
    "vds": "21144",
    "vis": "Y5123456",
    "plant": "5",
    "serial": "123456",
    "modelYearCode": "Y",
    "modelYear": 2000,
    "checkCharacter": "0",
    "checkDigitExpected": "7",
    "checkDigitStatus": "not_used",
    "region": "Европа",
    "manufacturer": "АвтоВАЗ",
    "country": "Россия",
    "source": "iso3779"
  }
}

Проверка наличия залогов по VIN

0,88 ₽

POST /v1/methods/zalog

Поле	Что передать	Обязательно
`vin`	VIN, 17 символов. Латиница и цифры, без I, O и Q.	одно из
`frame`	Номер кузова, 6–24 символа.	одно из

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/zalog \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"vin":"XTA211440Y5123456"}'

{
  "ok": true,
  "sandbox": false,
  "method": "zalog",
  "priceRub": 0.88,
  "charged": true,
  "balanceRub": 999.12,
  "result": {
    "pledged": false,
    "found": 0,
    "total": 0,
    "vin": "XTA211440Y5123456",
    "frame": "",
    "records": []
  }
}

Поиск залогов по VIN

2,56 ₽

POST /v1/methods/zalogvin

Поле	Что передать	Обязательно
`vin`	VIN, 17 символов. Латиница и цифры, без I, O и Q.	одно из
`frame`	Номер кузова, 6–24 символа.	одно из

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/zalogvin \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"vin":"XTA211440Y5123456"}'

{
  "ok": true,
  "sandbox": false,
  "method": "zalogvin",
  "priceRub": 2.56,
  "charged": true,
  "balanceRub": 996.56,
  "result": {
    "pledged": true,
    "found": 1,
    "total": 1,
    "scope": "history",
    "vin": "JTEHD21A850036287",
    "frame": "",
    "records": [
      {
        "notificationId": "2015-000-291842-833",
        "regDate": "2015-01-29T16:40:08",
        "properties": [
          "VIN JTEHD21A850036287"
        ],
        "pledgors": [],
        "pledgees": [],
        "history": [
          {
            "notificationId": "2015-000-291842-833",
            "regDate": "2015-01-29T16:40:08",
            "type": "CREATION",
            "typeName": "Возникновение",
            "link": ""
          }
        ]
      }
    ]
  }
}

Использование в такси по госномеру

0,88 ₽

POST /v1/methods/taxi

Поле	Что передать	Обязательно
`plate`	Госномер, например А123ВС77.	да

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/taxi \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"plate":"А123ВС77"}'

{
  "ok": true,
  "sandbox": false,
  "method": "taxi",
  "priceRub": 0.88,
  "charged": true,
  "balanceRub": 999.12,
  "result": {
    "taxi": true,
    "active": true,
    "found": 1,
    "plate": "Н453ТС69",
    "records": [
      {
        "region": "Тверская область",
        "number": "006669",
        "date": "04.10.2022",
        "status": "действующая",
        "plate": "Н453ТС69",
        "mark": "KIA",
        "model": "RIO",
        "year": "2020",
        "color": "белый"
      }
    ]
  }
}

Ограничение на открытие счетов

0,88 ₽

POST /v1/methods/innrestrict

Поле	Что передать	Обязательно
`inn`	ИНН, 10 или 12 цифр.	да

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/innrestrict \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"inn":"7707083893"}'

{
  "ok": true,
  "sandbox": false,
  "method": "innrestrict",
  "priceRub": 0.88,
  "charged": true,
  "balanceRub": 999.12,
  "result": {
    "restricted": false,
    "found": 0,
    "inn": "7707083893",
    "name": "",
    "records": []
  }
}

Долги по ФИО (ФССП)

2,56 ₽

POST /v1/methods/fsspdata

Поле	Что передать	Обязательно
`fio`	Фамилия и имя, можно с отчеством.	да
`birthDate`	Дата рождения, дд.мм.гггг.	да
`region`	Регион.	да

Пример запроса и ответа

curl -s -X POST https://proverka-vin.ru/api/v1/methods/fsspdata \
  -H "Authorization: Bearer pv_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"fio":"Иванов Иван Иванович","birthDate":"01.02.1980","region":"Москва"}'

{
  "ok": true,
  "sandbox": false,
  "method": "fsspdata",
  "priceRub": 2.56,
  "charged": true,
  "balanceRub": 997.44,
  "result": {
    "found": 0,
    "region": "Москва",
    "regionId": "77",
    "birthDate": "01.02.1980",
    "records": []
  }
}

Скоро: ещё 32 методов

Методы в прайсе, источники подключаются. Вызов сейчас вернёт 503 source_offline без списания.

Метод	Имя	Цена
Проверка данных ГИБДД по VIN	`gai`	16,8 ₽
Получение полной информации по VIN	`fullapi`	4,24 ₽
Получение информации по параметрам	`api`	2,56 ₽
Получение информации по номеру кузова	`frameapi`	8,4 ₽
Поиск сервисной истории	`servicemaintenance`	21,04 ₽
Получение пробега	`probeg`	0,88 ₽
Коллекция пробегов	`probeg2`	1,68 ₽
История регистрации ГИБДД по VIN (кэш)	`gibddhistory`	1,68 ₽
История регистрационных действий ГИБДД	`regperiods`	15,12 ₽
ДТП по VIN (кэш)	`dtp`	0,48 ₽
Получение информации о штрафах	`getfineinfo`	1,68 ₽
Пройденные ТО	`eaisto`	0,88 ₽
Поиск фотографий	`pic`	1,68 ₽
Расшифровка VIN (альтернативная)	`vindecode2`	2,56 ₽
Проверка использования в каршеринге по госномеру	`carshering`	4,24 ₽
Поиск лизинга по VIN	`leasing`	1,68 ₽
Получение информации по госномеру	`convertb2b`	4,24 ₽
Получение информации о таможенном оформлении	`customs`	1,68 ₽
Уплата утилизационного сбора по VIN	`utilization`	1,68 ₽
Средняя цена (без детализации)	`priceapi`	1,68 ₽
Средняя цена (мотоциклы)	`priceapimoto`	1,68 ₽
Средняя цена	`carprices`	0,88 ₽
Средняя цена (расширенный)	`avgcarprice`	2,56 ₽
Средняя цена по VIN	`avgpricebyvin`	3,36 ₽
Получение VIN по госномеру	`number2vin`	0,88 ₽
Поиск VIN по госномеру	`vinbynumber`	8,4 ₽
Поиск госномера по VIN	`vin2number`	4,24 ₽
Поиск СТС по госномеру	`number2sts`	0,88 ₽
Распознавание госномеров	`numberrecognize`	0,64 ₽
Объявления по VIN	`offerbyvin`	0,88 ₽
Объявления по госномеру	`offerbygosnum`	0,88 ₽
Реестр банкротов	`debtor`	0,88 ₽

Баланс и пополнение

На ключе три баланса: отчёты «Автотека», JSON-отчёты и рубли для методов. Удобнее пополнять в кабинете; через API — так:

GET `/v1/balance`

Остатки и цены ключа.

curl -s https://proverka-vin.ru/api/v1/balance \
  -H "Authorization: Bearer pv_live_ВАШ_ТОКЕН"

POST `/v1/topup`

Счёт на оплату (ЮKassa: карта, СБП). {"product":"autoteka","count":50}, {"product":"json","count":100} или {"product":"methods","amountRub":1000}. В ответе paymentUrl; после оплаты баланс пополнится сам.

curl -s -X POST https://proverka-vin.ru/api/v1/topup \
  -H "Authorization: Bearer pv_live_ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"product":"methods","amountRub":1000}'

Ошибки и лимиты

Ошибка — HTTP-код и JSON {"error": "код", "message": "текст для человека"}.

HTTP	error	Что значит
400	`invalid_query, invalid_vin, missing_input…`	Неверные входные данные. В message — что исправить.
401	`missing_token, invalid_token`	Нет заголовка с ключом, ключ неверный или отозван.
402	`insufficient_credits, insufficient_balance`	Не хватает отчётов или рублей. Пополните баланс в кабинете.
404	`not_found, unknown_method`	Нет такого отчёта (или он чужой) либо метода.
429	`rate_limited`	Больше 30 запросов в минуту на ключ. Повторите позже.
502	`method_failed`	Источник не ответил. Деньги не списаны, можно повторить.
503	`source_offline`	Метод в прайсе, источник ещё не подключён. Деньги не списаны.

Лимит — 30 запросов в минуту на ключ. Не передавайте ключ в адресе (?api_key= не принимается) и не встраивайте его во фронтенд: утёкший ключ отзовите в кабинете.

Вопросы

Сколько стоит?

Отчёт «Автотека» — 149 ₽, JSON-отчёт — 49 ₽ для ключей, выпущенных в кабинете. Методы — по прайсу выше. Для потока от 100 отчётов в месяц договоримся об индивидуальной цене — напишите в поддержку.

Чем тестовый ключ отличается от боевого?

Тестовый pv_test_… бесплатный: тот же формат ответов, но данные демонстрационные, к источникам он не обращается. Боевой pv_live_… работает с реальными данными и списывает баланс.

Что если отчёт не собрался?

Статус failed, отчёт возвращается на баланс. Методы списывают деньги только при успешном ответе.

Можно передать ключ в адресе запроса?

Нет. Только заголовком Authorization: Bearer … или X-Api-Key: адреса сохраняются в логах и истории браузера.

Ключ утёк — что делать?

Отзовите его в кабинете кнопкой «Отозвать» и выпустите новый. Отозванный ключ перестаёт работать сразу; баланс отозванного ключа переносит поддержка.

Как привязать Telegram?

В кабинете нажмите «Привязать Telegram» и откройте бота по ссылке. После этого баланс, пополнение и уведомления доступны в боте по команде /developers. Отвязать можно там же, в кабинете.

У меня уже есть ключ из Telegram-бота или от менеджера

В кабинете нажмите «Привязать существующий ключ» и вставьте полный токен — ключ с балансом появится в списке.

API для проверки автомобилей

Кабинет партнёра

Быстрый старт

Отчёты

POST /v1/reports

POST /v1/reports/json

GET /v1/reports/{id}

Методы

Баланс и пополнение

GET /v1/balance

POST /v1/topup

Ошибки и лимиты

Вопросы

POST `/v1/reports`

POST `/v1/reports/json`

GET `/v1/reports/{id}`

GET `/v1/balance`

POST `/v1/topup`