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.
Get API access
Connect your key to run every request on these pages against your own data. No key yet? Ask us for a demo key: the same JSON as the paid plans.