CarStat.dev
Подключить ключ
Объекты

Объект автомобиля

Один физический автомобиль с характеристиками, всеми объявлениями, доступными вашему ключу, а на детальных эндпоинтах — с полными отчётами. Атрибуты, которые источник не предоставил, обычно отсутствуют, а не равны null.

Недоступные корневые атрибуты часто отсутствуют. Вложенные значения могут быть null. /search возвращает флаги наличия без полных массивов отчётов; /cars и точные поиски прикрепляют отчёты. Объявления ограничены набором ключа/доменов, но могут включать другие объявления того же объединённого автомобиля. Никогда не считайте, что первое объявление — запрошенное.

idstringвсегда в ответе

Непрозрачный внутренний идентификатор автомобиля. Храните его как строку.

has_inspectionsbooleanвсегда в ответе

Всегда присутствует, как true или false. true, если у автомобиля есть хотя бы один публичный опубликованный осмотр в одном из его объявлений; false, если нет ни одного. /search, /cars и /cars/{car_id} возвращают сохранённый флаг, поэтому он может быть true при пустом inspections (например, если отчёт относится к объявлению вне ваших источников). /listing/{domain_id}/{listing_id} пересчитывает его только по этому объявлению. Отчёты отображайте из массива inspections; флаг используйте для бейджей и фильтров.

has_history_reportsbooleanвсегда в ответе

Всегда присутствует, как true или false. true, если хотя бы один публичный отчёт об истории автомобиля привязан к объявлению в ваших источниках; иначе false. Детальные эндпоинты пересчитывают его по возвращаемым vehicle_history_reports. Для бейджа по отдельному источнику используйте listings[].has_history_reports.

yearinteger
monthinteger
engine_volumeinteger
cylindersinteger
doorsinteger
seatsinteger
transmission_stepsinteger
power_hpinteger
battery_capacity_kwhnumber
vinstring
brandobject
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
modelobject
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
body_typeobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
transmissionobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
fuelobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
colorobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
market_originobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
drive_wheelsobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
emission_standardobjectможет быть null
Вложенных атрибутов: 2
idintegerвсегда в ответе
namestringможет быть nullвсегда в ответе
steering_wheel_positionobjectможет быть null

1 = left (левый руль); 2 = right (правый руль). В ответе — объект id/name; фильтр поиска принимает целочисленный ID. Отсутствует, если недоступно, или равно null, если сохранённое значение не удалось сопоставить.

Вложенных атрибутов: 2
idintegerвсегда в ответе

Одно из: 1, 2.

namestringвсегда в ответе

Одно из: left, right.

badgestring
created_atstring
updated_atstring
option_idsarray of integerвсегда в ответе
listingsarray of Listingвсегда в ответе
inspectionsarray of Inspection
vehicle_history_reportsarray of VehicleHistory
hashstringможет быть nullвсегда в ответе

SHA-256 сериализованных данных автомобиля без корневых created_at/updated_at и без created_at/last_seen_at/updated_at объявлений. Включает location_details, поэтому добавление этого поля или изменение локализованных названий может изменить hash.

Автомобиль · все поля заполненыПример
{31 keys
"id": "example-car-021"
"has_inspections": true
"has_history_reports": true
"year": 2021
"month": 3
"vin": "EXAMPLEVIN0000021"
"brand": {2 keys
"id": 101
"name": "Example brand"
}
"model": {2 keys
"id": 201
"name": "Example SUV"
}
"badge": "2.0 Hybrid AWD Premium"
"engine_volume": 1999
"cylinders": 4
"doors": 5
"seats": 5
"transmission_steps": 8
"power_hp": 245
"battery_capacity_kwh": 1.6
"body_type": {2 keys
"id": 5
"name": "suv"
}
"transmission": {2 keys
"id": 1
"name": "automatic"
}
"fuel": {2 keys
"id": 3
"name": "hybrid"
}
"color": {2 keys
"id": 9
"name": "grey"
}
"market_origin": {2 keys
"id": 1
"name": "europe"
}
"drive_wheels": {2 keys
"id": 3
"name": "all"
}
"emission_standard": {2 keys
"id": 6
"name": "euro_6"
}
"steering_wheel_position": {2 keys
"id": 1
"name": "left"
}
"created_at": "2026-08-01T09:00:00Z"
"updated_at": "2026-09-28T06:00:00Z"
"option_ids": [6 items]
"listings": [2 items]
"inspections": [1 item]
"vehicle_history_reports": [1 item]
"hash": "3f1c9a0d7e5b2c48a61f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b"
}

Значения примера подобраны так, чтобы показать все поля. ID перечислений, валют и местоположений реальные; названия, VIN и URL вымышлены. Если поля нет в реальном ответе, значит, источник его не предоставил.