POST /stats/partner/predict_by_vin_or_lp

Возвращает оценочную стоимость транспортного средства на основании VIN или ГРЗ и информацию об автомобиле, которая найдена по VIN или ГРЗ.

Формат запроса

POST https://apiauto.ru/1.0/stats/partner/predict_by_vin_or_lp

Формат тела запроса

{
  "vin_or_lp":{string},
  "mileage":{integer},
  "geo_id":{integer},
  "seller_type":{string}
}

vin_or_lp*

VIN или ГРЗ автомобиля.

mileage*

Пробег в километрах.

geo_id*

Идентификатор населенного пункта пользователя. Справочник регионов можно скачать по ссылке.

seller_type

Тип продавца.

Допустимые значения:
  • PRIVATE — частное лицо;
  • COMMERCIAL — салон.

* Обязательный параметр

Общая структура ответа приведена ниже. Порядок следования элементов не гарантируется. В структуре могут присутствовать служебные параметры, которые не описаны в таблице.

Формат ответа

{
    "price_range": {
      "from":{integer},
      "to":{integer}
    },
    "found_info":{
      "tech_param_id":{integer},
      "color":"{string}",
      "owners_count":{integer},
      "year":{integer},
      "pts_original":{boolean},
      "steering_wheel": "{string}",
      "complectation_id":{integer},
      "mark":"{string}",
      "model":"{string}",
      "super_gen_id":{integer},
      "configuration_id":{integer},
      "photos":{
        "{string}":"{string}",
        "{string}":"{string}",
        "{string}":"{string}"
      },
      "horse_power": {integer},
      "transmission": "{string}",
      "registered_in_russia": {boolean},
      "mileage": {integer},
      "geo_id": {integer},
      "geo_title": "{string}",
      "pts": "{string}"
    },
    "car_history": {
      "dtp_count":{integer},
      "has_fines":{boolean},
      "was_in_car_sharing":{boolean},
      "was_in_pledge":{boolean},
      "was_in_taxi":{boolean},
      "repair_max_total_cost":{integer},
      "registered_in_gibdd":{boolean}

    }
}

price_range

Диапазон оценочной стоимости на Авто.ру.

from

Нижняя граница оценочной стоимости в рублях/валюте.

to

Верхняя граница оценочной стоимости в рублях/валюте.

found_info

Найденная техническая информация по VIN или ГРЗ автомобиля

tech_param_id

Идентификатор набора технических характеристик ТС. Список наборов технических характеристик с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

color

Цвет транспортного средства в HEX-формате. Список допустимых значений смотрите в Справочнике цветов.

owners_count

Количество владельцев.

year

Год выпуска ТС.

pts_original

Признак наличия оригинала ПТС.

Допустимые значения:
  • true — оригинал ПТС в наличии;
  • false — оригинал ПТС отсутствует.

steering_wheel

Расположение руля.

Допустимые значения:
  • LEFT — левый руль;
  • RIGHT — правый руль.

complectation_id

Идентификатор комплектации. Список идентификаторов можно получить с помощью операции GET /reference/catalog/cars/complectations

mark

Марка.

model

Модель.

super_gen_id

Идентификатор поколения.

configuration_id

Идентификатор конфигурации. Список конфигураций с идентификаторами можно получить с помощью операции GET /search/cars/breadcrumbs.

photos

Объект с возможными размерами фотографии. Пример: "mobile":"//images.md../943h4345/68..cd..ceeb..regbbdf43/mobile", где первый параметр — размер картинки, второй — URL-адрес картинки.

horse_power

Мощность двигателя в л. с.

transmission

Тип коробки передач. Параметр актуален только для легковых автомобилей.

Допустимые значения:
  • MECHANICAL — механическая коробка;
  • AUTOMATIC — автоматическая коробка;
  • ROBOT — коробка-робот;
  • VARIATOR — коробка-вариатор.

registered_in_russia

Регистрация в Российской Федерации.

Допустимые значения:
  • true — транспортное средство зарегистрировано в Российской Федерации;
  • false — транспортное средство не зарегистрировано в Российской Федерации.

mileage*

Пробег в километрах.

geo_id*

Идентификатор населенного пункта пользователя. Справочник регионов можно скачать по ссылке.

geo_title

Название населенного пункта пользователя. Справочник регионов можно скачать по ссылке.

pts

Наличие ПТС.

Допустимые значения:
  • ORIGINAL — оригинал ПТС;
  • DUPLICATE — дубликат ПТС.

car_history

Детали истории владения автомобилем по данным Отчетов Авто.ру.

dtp_count

Количество ДТП.

has_fines

Наличие штрафов.

Допустимые значения:
  • true — есть штрафы;
  • false — нет штрафов.

was_in_car_sharing

Регистрация в каршеринге.

Допустимые значения:
  • true — есть регистрация;
  • false — нет регистрации.

was_in_pledge

Залог.

Допустимые значения:
  • true — автомобиль в залоге;
  • false — автомобиль не в залоге.

was_in_taxi

Регистрация в такси.

Допустимые значения:
  • true — есть регистрация;
  • false — нет регистрации.

repair_max_total_cost

Максимальная стоимость ремонта после ДТП.

registered_in_gibdd

Регистрация в ГИБДД.

Допустимые значения:
  • true — есть регистрация;
  • false — нет регистрации.

Коды ответа

Код

Причина

Описание

200

OK

Успешный запрос.

Примечание

Такой ответ может быть получен, даже если найденной информации недостаточно, чтобы оценить авто.

202

IN_PROGRESS

VIN не был найден по заданному ГРЗ, и поиск продолжается. Нужно повторить запрос позже.

400

BAD_REQUEST

Ошибка в запросе: неверный VIN или ГРЗ.

404

NOT_FOUND

Не найдена информация по VIN или ГРЗ для этого автомобиля, или не найден VIN по ГРЗ.

500

INTERNAL SERVER ERROR

Внутренняя ошибка сервера.

Пример

Запрос:

curl -i -X POST 'https://apiauto.ru/1.0/stats/partner/predict_by_vin_or_lp' -H 'x-authorization: 2dtrer432...' -d '{"vin_or_lp": "К286ТХ77", "mileage": 24000, "geo_id": 213, "seller_type": "PRIVATE"}' -H 'Accept: application/json' -H 'Content-Type:application/json'

Ответ:

HTTP/1.1 200 OK
Server: envoy
Date: Thu,14 Aug 2025 20:12:36 GMT
Content-Type: application/json
Content-Length: 140
Connection: keep-alive

{
    "price_range": {
      "from": 0,
      "to": 0,
    },
    "found_info": {
      "tech_param_id": 20532706,
      "color": "FAFBFB",
      "owners_count": 2,
      "year": 2016,
      "pts_original": true,
      "steering_wheel": "LEFT",
      "complectation_id": 21034571
      "mark": "MITSUBISHI",
      "model": "ECLIPSE",
      "super_gen_id": 21107295,
      "configuration_id": 2305627,
      "photos": {
        "main":"//avatars.mds.yandex.net/get-verba/216201/2a000001609a350783de0d3a8c593d7f8dd0/auto_main",
      },
      "horse_power": 140,
      "transmission": "MECHANICAL",
      "registered_in_russia": true,
      "mileage": 0,
      "geo_id": 213,
      "geo_title": "Москва",
      "pts": "ORIGINAL"
    },
    "car_history": {
      "dtp_count": 0,
      "has_fines": true,
      "was_in_car_sharing": true,
      "was_in_pledge": true,
      "was_in_taxi": true,
      "repair_max_total_cost": 0,
      "registered_in_gibdd": true,
}

* Обязательный параметр

Предыдущая
POST /stats/predict
Следующая
POST /auth/login