Loading the example…
Objects
The vehicle history object
A standardized history report for one listing.
History belongs to the exact domain_id + listing_id in vehicle_ref. Do not copy it to another listing. Missing or empty reports do not prove an accident-free history. Taxonomies can grow; preserve unknown keys and source evidence.
schema_versionintegernullable
mapper_contract_versionintegernullable
report_idstringnullable
statusstringnullable
visibilitystringnullable
languagestringnullable
created_atstringnullable
system_updated_atstringnullable
vehicle_refobject
4 child attributes
domain_idinteger
listing_idstring
site_car_idintegernullable
vinstringnullable
vehicle_snapshotobject | []
Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.
18 child attributes
titlestringnullable
brandstringnullable
modelstringnullable
generationstringnullable
badgestringnullable
vinstringnullable
listing_idstringnullable
source_domainstringnullable
fuel_typestringnullable
transmissionstringnullable
engine_typestringnullable
engine_codestringnullable
first_registered_atstringnullable
colorstringnullable
body_stylestringnullable
yearintegernullable
engine_volume_ccintegernullable
mileage_kmnumbernullable
sourceobject | []
Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.
6 child attributes
source_keystringnullable
source_typestringnullable
source_report_idstringnullable
source_languagestringnullable
mapper_versionstringnullable
imported_atstringnullable
accessobject | []
Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.
1 child attributes
attach_to_listingboolean
mediaarray of object
11 child attributes
idstringnullable
type_keystringnullable
external_urlstringnullable
local_pathstringnullable
original_namestringnullable
extensionstringnullable
descriptionstringnullable
block_idstringnullable
checked_item_idstringnullable
server_idintegernullable
sort_orderintegernullable
filesarray of object
11 child attributes
idstringnullable
type_keystringnullable
external_urlstringnullable
local_pathstringnullable
original_namestringnullable
extensionstringnullable
descriptionstringnullable
block_idstringnullable
checked_item_idstringnullable
server_idintegernullable
sort_orderintegernullable
limitationsarray of object
4 child attributes
idstringnullable
type_keystringnullable
descriptionstringnullable
source_labelstringnullable
translationsobject
6 child attributes
languagestringalways in response
fallback_languagestringalways in response
termsmapalways in response
Labels by taxonomy type and canonical key: terms[type][key]. Empty dictionary is {}.
missingarray of objectalways in response
3 child attributes
typestringalways in response
keystringalways in response
fallback_languagestringnullablealways in response
taxonomy_availablebooleanalways in response
source_text_translatedbooleanalways in response
checked_atstringnullable
coverageobject | []
Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.
4 child attributes
completeness_keystringnullable
period_startstringnullable
period_endstringnullable
section_keysarray of string
summaryobject | []
Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.
13 child attributes
first_registered_atstringnullable
currencystringnullable
owner_change_countintegernullable
registration_change_countintegernullable
insurance_claim_countintegernullable
vehicle_damage_claim_countintegernullable
third_party_damage_claim_countintegernullable
total_loss_countintegernullable
flood_total_loss_countintegernullable
flood_partial_loss_countintegernullable
theft_countintegernullable
vehicle_damage_claim_costnumbernullable
third_party_damage_claim_costnumbernullable
checksarray of object
9 child attributes
idstringnullable
type_keystringnullable
evidence_type_keystringnullable
verification_keystringnullable
source_codestringnullable
source_labelstringnullable
descriptionstringnullable
result_keystring
One of: present, not_present, unknown, not_applicable.
countintegernullable
eventsarray of object
22 child attributes
idstringnullable
type_keystringnullable
subtype_keystringnullable
occurred_atstringnullable
ended_atstringnullable
status_keystringnullable
evidence_type_keystringnullable
verification_keystringnullable
organization_namestringnullable
organization_role_keystringnullable
currencystringnullable
source_codestringnullable
source_labelstringnullable
descriptionstringnullable
date_precision_keystring
One of: datetime, day, month, year, unknown.
mileage_kmnumbernullable
amount_totalnumbernullable
amount_insurance_benefitnumbernullable
amount_partsnumbernullable
amount_labornumbernullable
amount_paintingnumbernullable
detailsarray of object
7 child attributes
keystringnullable
value_textstringnullable
value_datestringnullable
unit_keystringnullable
source_codestringnullable
source_labelstringnullable
value_numbernumbernullable
History report · every field filledExample
{21 keys
"schema_version": 1
"mapper_contract_version": 1
"report_id": "history-a"
"status": "published"
"visibility": "public"
"language": "en"
"created_at": "2026-08-14T08:00:00+00:00"
"checked_at": "2026-08-14T08:00:00+00:00"
"system_updated_at": "2026-08-15T03:00:00+00:00"
"vehicle_ref": {3 keys
"domain_id": 101
"listing_id": "example-listing-1"
"vin": "EXAMPLEVIN0000021"
"vehicle_snapshot": {6 keys
"title": "Example SUV 2.0 AWD"
"brand": "Example"
"model": "SUV"
"year": 2021
"vin": "EXAMPLEVIN0000021"
"mileage_km": 98700
"source": {6 keys
"source_key": "example_history"
"source_type": "external_api"
"source_report_id": "H-2026-0814"
"source_language": "en"
"mapper_version": "example-v1"
"imported_at": "2026-08-15T02:58:00+00:00"
"access": {1 key
"attach_to_listing": true
"coverage": {4 keys
"completeness_key": "complete"
"period_start": "2021-03-01"
"period_end": "2026-08-31"
"section_keys": [7 items
0: "ownership"
1: "insurance"
2: "registration"
3: "maintenance"
4: "mileage"
5: "recall"
6: "usage"
"summary": {13 keys
"first_registered_at": "2021-03-18"
"owner_change_count": 2
"registration_change_count": 1
"insurance_claim_count": 2
"vehicle_damage_claim_count": 1
"third_party_damage_claim_count": 1
"vehicle_damage_claim_cost": 1450
"third_party_damage_claim_cost": 780
"total_loss_count": 0
"flood_total_loss_count": 0
"flood_partial_loss_count": null
"theft_count": 0
"currency": "eur"
"checks": [10 items
]"events": [6 items
]"media": []
"files": []
"limitations": [1 item
0: {3 keys
"id": "lim-1"
"type_key": "other"
"description": "Registration data before 2021 not covered"
"translations": {6 keys
}Example values chosen to show every field. IDs for enums, currency and locations are real; names, VINs and URLs are made up. A field you don't see in a real response was not supplied by the source.