A damaged vehicle is offered for purchase: front damage, airbags deployed, high mileage. The dealer wants to know whether a repair pays off, the recycler whether the vehicle may be sold at all. Both questions hinge on the same classification — and the new European end-of-life vehicle rules require it to be reasoned.
The chain joins two surfaces with separate roles: the Hub delivers an image finding and a revenue estimate, the Compliance surface records the classification at the receiving facility — by an independent, qualified person. The image finding grounds the suspicion; it is determined only in the file.
| Surface | Roles |
|---|---|
| Hub + Compliance | Vehicle recyclers, Vehicle trading, Experts and insurers |
What this case requires
- Photos from several angles. The classification takes one to ten image addresses; what was not photographed appears in
coverage.viewsMissing. - Market value and repair estimate where known. Without the market value the economic axis remains
nicht_beurteilbar. - A receiving, recognised facility. The Compliance surface belongs to the facility taking the vehicle in; it is the sole legal issuer.
- An independent, qualified person for the assessment. The Annex I assessment requires a signed-in person in the compliance lead role.
- The entitlement to query the vehicle. With the call you confirm that you are the keeper, the owner or demonstrably authorised or otherwise legally entitled, and that you use the identification number solely for the stated permissible purpose.
The sequence
The table names the responsible call per stage and what exists afterwards. The reasoning for why a stage cannot be skipped follows below it.
| Stage | Call | What exists afterwards |
|---|---|---|
| Obtain the image finding | POST /vision/vehicle/elv-classification | classification, technicallyIrreparable and economicallyIrreparable — with an observation per criterion |
| Estimate the parts revenue | GET /vin/{vin}/economic-evaluation | revenuePotential and purchaseRecommendation for the purchase decision |
| Open the case at the receiving facility | POST /compliance/cases | legalProfile DE_FZV_ANNEX_9_CURRENT or EU_ELV_2028 sets the rule set |
| Have it assessed by an expert | POST /compliance/cases/{id}/annex-i-assessments | partACriteria, partBCriteria and conclusion — by an independent, qualified person |
Why each stage is needed
- Obtain the image finding.
POST /vision/vehicle/elv-classificationtakesimageUrlsand optionallyvehiclewithfirstRegistration,mileageKm,marketValueEur,repairEstimateEuranddamageDescription. Back comeclassification,technicallyIrreparable,economicallyIrreparable, per criterionfinding,confidenceandobservation, pluseconomicAssessment,coverageandvisualOnly. - Estimate the parts revenue.
GET /vin/{vin}/economic-evaluationreturnsrevenuePotentialandpurchaseRecommendation. The recommendation deliberately rests on the price minimum — a buyer pays before a single part is sold. - Open the case at the receiving facility.
POST /compliance/casestakesfacilityId,jurisdiction,legalProfilewithDE_FZV_ANNEX_9_CURRENTorEU_ELV_2028, and the vehicle. From here the classification is no longer an estimate but part of a file with an event chain. - Have it assessed by an expert.
POST /compliance/cases/{id}/annex-i-assessmentstakesexpertPartyId,qualificationId,independenceAttestationId,partACriteria,partBCriteriaandconclusion. A signed-in person carries out this action; the image finding can prepare it but not replace it.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: altfahrzeug-pruefung-0917' \
-d '{"imageUrls":["https://example.com/front.jpg","https://example.com/seite-links.jpg","https://example.com/innenraum.jpg"],"quality":"standard","vehicle":{"firstRegistration":"2011-04","mileageKm":236000,"marketValueEur":1500,"repairEstimateEur":4200,"damageDescription":"Frontschaden nach Wildunfall, Airbags ausgelöst"}}' \
'https://api.tapinomahub.com/vision/vehicle/elv-classification'What you end up with
What remains is a classification that starts with a traceable image finding, has an economic basis and ends with a reasoned determination by a qualified person. Whether the vehicle is sold or recycled can then be defended.
Where to find this in the documentation
The binding field lists, error codes and sample responses live in this surface’s OpenAPI contract at docs.tapinomahub.com (tapinoma-hub, tapinoma-compliance). All use cases arranged by surface and role: overview of the use cases.
Sources and legal references
Frequently asked
Does the image finding determine that a vehicle is end-of-life?
No. It delivers a reasoned indication with criteria and observations. The classification is determined by a qualified person in the recognised facility’s file.
What happens if photos are missing?
coverage.viewsMissing names the missing views.
Can a dealership open the Compliance case itself?
The Compliance surface belongs to the receiving, recognised facility. It is the sole legal issuer; anyone merely handing a vehicle over works with the image finding and the handover.
