CarStat.dev
Руководство

Отчёты об истории автомобиля

История охватывает регистрацию, владение, использование, пробег и страховые события. В отличие от характеристик автомобиля, отчёт об истории относится к одному объявлению: точной паре vehicle_ref.domain_id + listing_id. Не копируйте его в другие объявления того же автомобиля.

Что внутри

summaryСчётчики, например owner_change_count и insurance_claim_count, и суммы страховых выплат в summary.currency.
coverageПериод и разделы, которые источник действительно охватывает. Показывайте это в начале.
checks[]Проверки «да/нет». result_key: present, not_present, unknown, not_applicable.
events[]Записи хронологии. Учитывайте date_precision_key (day, month, year …), а не показывайте выдуманную точную дату.
  • Пустой или отсутствующий отчёт не доказывает чистую историю.
  • Сохраняйте явные нули: theft_count: 0 — это результат проверки, а null — нет.
  • Если отчётов несколько, показывайте каждый как отдельный источник. Не объединяйте события из разных отчётов.
vehicle_history_reports[0] · фрагментLive
{
  "vehicle_ref": {
    "domain_id": 55613,
    "vin": "wddhf0cb3ea952710",
    "listing_id": "42802955"
  },
  "coverage": {
    "period_end": "2026-05-28T00:00:00+00:00",
    "period_start": "2014-04-01T00:00:00+00:00",
    "completeness_key": "complete",
    "section_keys": [
      "inspection",
      "insurance",
      "legal",
      "maintenance",
      "mileage",
      "ownership",
      "recall",
      "registration",
      "usage"
    ]
  },
  "summary": {
    "total_loss_count": 0,
    "registration_change_count": 4,
    "third_party_damage_claim_cost": 0,
    "theft_count": 0,
    "owner_change_count": 1,
    "first_registered_at": "2014-04-18T00:00:00+00:00",
    "insurance_claim_count": 1,
    "vehicle_damage_claim_count": 1,
    "third_party_damage_claim_count": 0,
    "vehicle_damage_claim_cost": 1564000,
    "currency": "krw",
    "flood_total_loss_count": 0
  },
  "checks": [
    {
      "result_key": "present",
      "count": 1,
      "id": "accident_history",
      "source_code": "insurance_v2.accidentCnt",
      "type_key": "accident_history",
      "evidence_type_key": "insurance_database",
      "verification_key": "source_reported"
    },
    {
      "result_key": "not_present",
      "count": 0,
      "id": "business_use_history",
      "source_code": "insurance_v2.business|details.usage_types",
      "type_key": "business_use_history",
      "evidence_type_key": "insurance_database",
      "verification_key": "source_reported"
    }
  ],
  "events": [
    {
      "occurred_at": "2014-04-01T00:00:00+00:00",
      "date_precision_key": "month",
      "source_label": "Change registration",
      "details": [
        {
          "value_text": "Change registration",
          "source_code": "Classification of change",
          "source_label": "Classification of change",
          "key": "registration_change_classification"
        }
      ],
      "id": "encar_history_e6f9843e49b29dd086531aeb",
      "type_key": "registration_change",
      "evidence_type_key": "vehicle_history_timeline",
      "verification_key": "source_reported"
    }
  ]
}