POST /search is validation-only: it normalizes the input and does not call providers or consume credits.
Search types
Canonical types:vinplate_fr
plate,plaque,plaque_fr,license_plate_fr,french_plate, andimmatriculation->plate_fr
AB-123-CD, temporary WW plates, diplomatic/consular formats, and older departmental formats such as 123 AB 75.
Endpoint groups
save: true is only supported on /all.
Fast path
Validate a French plate before launching enrichment./all when you want a saved result or a single generic entry point.
Response data
Forplate_fr, the response includes:
- parsed format, normalized plate, and format label
- SIV sequence metadata or old departmental metadata when available
- official links for HistoVec, ANTS, SIV, and technical inspection
- provider vehicle candidates
- a mapped
vehicle.presentationobject in English for vehicle identity, engine, transmission, steering, model year, fluids, and capacities - technical details (
castrolfield) and vehicle image metadata when available
vehicle.found: false if no vehicle candidate is returned by the provider.
For vin, the response includes:
- identity fields such as make, model, year, body class, trim, vehicle type, and manufacturer
- engine, drivetrain, electric, plant, and safety equipment details
- NHTSA recalls, complaints, NCAP safety ratings, and attention scoring
Response example
APOST /tools/vehicle-history-finder/all response for a sample VIN. Lists are shortened to one item; counts show the full size.
Vehicle History Finder /all response
Vehicle History Finder /all response
Individual endpoints
Each endpoint returns the same envelope with its ownoperation and query. Examples are anonymized and lists are shortened to one item.
POST /tools/vehicle-history-finder/search
POST /tools/vehicle-history-finder/search
POST /tools/vehicle-history-finder/vin
POST /tools/vehicle-history-finder/vin
POST /tools/vehicle-history-finder/plate-fr
POST /tools/vehicle-history-finder/plate-fr
Availability
Personal owner data and full official vehicle history remain available only through official French services such as HistoVec or ANTS. Provider failures are normalized as API errors on focused routes when the main provider fails. Secondary metadata such as vehicle images can be omitted without failing the whole plate response.Caching
Provider responses are cached by normalized input and provider:- vehicle technical details: 12 hours
- vehicle image metadata: 24 hours
- NHTSA VIN decode: 24 hours
- NHTSA recalls and complaints: 6 hours
- NHTSA safety ratings: 24 hours