Connect key
Loading the example…
Objects

The inspection object

A standardized technical inspection. Only public, published reports are returned.

Only public, published reports. Canonical *_key values are translation keys; IDs and source labels are not. unknown never means ok. Open-ended taxonomies require a fallback for new keys. See the inspection guide on this page.

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
uuidstringnullable
inspected_atstringnullable
valid_untilstringnullable
updated_atstringnullable
participantsarray of object
5 child attributes
role_keystringnullable
namestringnullable
source_labelstringnullable
company_idintegernullable
user_idintegernullable
conclusionsobject | []

Object, or [] if the stored PHP object is empty. Missing report objects are returned as {}.

8 child attributes
overall_result_keystringnullable
accident_status_keystringnullable
water_damage_status_keystringnullable
fire_damage_status_keystringnullable
chemical_damage_status_keystringnullable
biohazard_status_keystringnullable
evaluation_scorestringnullable
notesstringnullable
source_claimsarray of object
6 child attributes
idstringnullable
type_keystringnullable
result_keystringnullable
source_codestringnullable
source_labelstringnullable
descriptionstringnullable
inspection_blocksarray of object
11 child attributes
idstringnullable
keystringnullable
result_keystringnullable

Inspection result taxonomy key. Common values: ok, issue, not_checked, not_applicable, not_equipped, unknown. New approved keys may appear.

source_codestringnullable
source_labelstringnullable
descriptionstringnullable
sort_orderintegernullable
checked_countintegernullable
passed_countintegernullable
issue_countintegernullable
not_checked_countintegernullable
checked_itemsarray of object
27 child attributes
idstringnullable
block_idstringnullable
block_keystringnullable
part_keystringnullable
part_labelstringnullable
location_keystringnullable
location_labelstringnullable
severity_keystringnullable
damage_rank_keystringnullable
accident_relevance_keystringnullable
recommendation_keystringnullable
clarificationstringnullable
visual_map_idstringnullable
visual_marker_idstringnullable
visual_marker_labelstringnullable
visual_shape_keystringnullable
source_codestringnullable
source_labelstringnullable
descriptionstringnullable
result_keystringnullable

Inspection result taxonomy key. Common values: ok, issue, not_checked, not_applicable, not_equipped, unknown. New approved keys may appear.

issue_type_keysarray of string
evidence_media_idsarray of string
visual_xnumbernullable
visual_ynumbernullable
visual_widthnumbernullable
visual_heightnumbernullable
measurementsarray of object
7 child attributes
idstringnullable
type_keystringnullable
value_textstringnullable
unit_keystringnullable
result_keystringnullable
descriptionstringnullable
value_numbernumbernullable
diagnostic_errorsarray of object
8 child attributes
idstringnullable
system_keystringnullable
system_labelstringnullable
codestringnullable
descriptionstringnullable
status_keystringnullable
severity_keystringnullable
source_labelstringnullable
Inspection · every field filledExample
{26 keys
"schema_version": 1
"mapper_contract_version": 1
"report_id": "inspection-a"
"uuid": null
"status": "published"
"visibility": "public"
"language": "en"
"inspected_at": "2026-08-14T09:30:00+00:00"
"valid_until": "2026-11-14T23:59:59+00:00"
"created_at": "2026-08-14T10:05:00+00:00"
"updated_at": null
"system_updated_at": "2026-08-15T03:00:00+00:00"
"vehicle_ref": {4 keys
"domain_id": 101
"listing_id": "example-listing-1"
"site_car_id": null
"vin": "EXAMPLEVIN0000021"
}
"vehicle_snapshot": {9 keys
"title": "Example SUV 2.0 AWD"
"brand": "Example"
"model": "SUV"
"year": 2021
"vin": "EXAMPLEVIN0000021"
"mileage_km": 98700
"fuel_type": "hybrid"
"transmission": "automatic"
"engine_type": "2.0 hybrid"
}
"source": {6 keys
"source_key": "example_inspector"
"source_type": "external_api"
"source_report_id": "A-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
}
"participants": [1 item
0: {5 keys
"role_key": "inspector"
"name": "Example Inspector"
"company_id": 10
"user_id": 20
"source_label": "Inspector"
}
]
"conclusions": {8 keys
"overall_result_key": "issue"
"accident_status_key": "issue"
"water_damage_status_key": "ok"
"fire_damage_status_key": "ok"
"chemical_damage_status_key": "not_checked"
"biohazard_status_key": "unknown"
"evaluation_score": "3.5"
"notes": "Example notes: structural repair on the right quarter panel; drive before buying."
}
"source_claims": [3 items
0: {4 keys
"id": "claim-1"
"type_key": "accident"
"result_key": "issue"
"source_label": "Accident history"
}
1: {4 keys
"id": "claim-2"
"type_key": "flood"
"result_key": "ok"
"source_label": "Flood damage"
}
2: {4 keys
"id": "claim-3"
"type_key": "exterior_repair_rank_2"
"result_key": "issue"
"source_label": "Structural panel repair"
}
]
"inspection_blocks": [9 items]
"checked_items": [9 items]
"diagnostic_errors": [2 items
0: {6 keys
"id": "dtc-1"
"system_key": "emission"
"code": "P0420"
"description": "Catalyst efficiency below threshold (bank 1)"
"status_key": "stored"
"severity_key": "medium"
}
1: {6 keys
"id": "dtc-2"
"system_key": "abs"
"code": "C0035"
"description": "Wheel speed sensor front left: intermittent signal"
"status_key": "history"
"severity_key": "minor"
}
]
"media": [3 items]
"files": [1 item]
"limitations": [2 items
0: {3 keys
"id": "lim-1"
"type_key": "underbody"
"description": "Underbody checked visually, no lift available"
}
1: {3 keys
"id": "lim-2"
"type_key": "battery"
"description": "Battery not load-tested"
}
]
"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.

I have a key