The vehicle record behind a listing, plus the specification, valuation and stock-photo services that fill it in.
https://api.reportauto.euThe vehicle record behind a listing or report: its plate, its condition ratings, and the lookups that fill in specification data from a VIN or plate.
Records the condition assessment — service history, keys, and the component ratings shown on the report.
Authentication API key
ID of the vehicle.
Condition assessment.
1curl -X PUT "https://api.reportauto.eu/api/cars/2159" \
2 -H "Authorization: API_KEY $CAROOM_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "condition": {
6 "has_service_history": true,
7 "last_service_date": "2021-07-13",
8 "has_smoked_in_car": false,
9 "keys_count": 1,
10 "rating_air_conditioning": 1,
11 "rating_brakes": 1,
12 "rating_engine": 1,
13 "rating_suspension": 1
14 }
15 }'Corrects the registration plate. Changing it re-runs the specification lookup against the new plate.
Authentication Access token
ID of the vehicle.
New registration plate.
1curl -X PUT "https://api.reportauto.eu/api/cars/19455" \
2 -H "Authorization: $CAROOM_ACCESS_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{ "plate": "697TNG" }'Asks the provider for the vehicle’s specification again, for when the first lookup came back empty or failed.
Authentication Bearer token
ID of the vehicle. The collection also passes a plate here.
1curl -X PATCH "https://api.reportauto.eu/api/cars/952MGV/retry_mnt_details" \
2 -H "Authorization: Bearer $CAROOM_ACCESS_TOKEN"Caroom’s façade over the vehicle-data vendors. Specifications come from a VIN or a plate, valuations from mileage and location, and the selector endpoints walk the year → make → model → style tree used by the manual entry flow.
Resolves a vehicle to its specification. Identify it by VIN, by plate, or by both — the plate needs the country and, in the US, the state.
Authentication None
Country of registration, e.g. USA.
The 17-character VIN.
Registration plate, as an alternative to the VIN.
State the plate is registered in, e.g. FL.
1curl "https://api.reportauto.eu/services/cars/specs?country_code=USA&vin=19UDE2F78GA013426"Overrides what the vendor returned — used when the decode picks the wrong trim or colour. Address the vehicle the same way as the lookup.
Authentication None
Country of registration.
The VIN.
Registration plate.
State the plate is registered in.
Correct style, from the selector endpoints below.
Manufacturer colour code, e.g. SI or PX8.
1curl -X PUT "https://api.reportauto.eu/services/cars/specs?country_code=USA&vin=19UDE2F78GA013426" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "color_code": "SI",
5 "style_id": 374375
6 }'Returns a valuation for the vehicle at the given mileage and location. The plate form, /services/cars/:plate/evaluate, still works but the VIN form is the current one.
Authentication None
The VIN.
Odometer reading, in miles.
Where the vehicle is, which moves the price.
Country of registration.
State of registration.
1curl "https://api.reportauto.eu/services/cars/evaluate?vin=4T1BF3EK8BU127976&miles=245000&country_code=USA&country_state_code=NY&postcode=33006"Returns comparable listings near a postcode, the market context behind a valuation.
Authentication None
The VIN.
Centre of the search.
Odometer reading, in miles.
1curl "https://api.reportauto.eu/services/cars/market_survey?vin=5FNRL5H90EB113163&postcode=33002&miles=125000"Backs manual vehicle entry: ask for years, then makes for a year, then models, then styles, and finally the detail for a style. Each level narrows the next through query parameters.
Authentication None
Which level of the tree to return.
Model year.
Vendor code for the make.
Model name.
Style to fetch detail for.
1curl "https://api.reportauto.eu/services/cars/selector/detail?styleId=429173"Internal helper services that resolve stock photography and decode VINs. Each has its own function URL and takes no authentication header.
Base URL AWS Lambda function URLs
Returns the specification a VIN decodes to — make, model, trim and body.
Authentication None
The 17-character VIN.
1curl -X POST "https://lsqxsnj2vurcn5o7ayqnyxsg6q0vfpdt.lambda-url.us-east-1.on.aws/" \
2 -H "Content-Type: application/json" \
3 -d '{ "vin": "19UDE2F78GA013426" }'Copies a stock image for a make and model into Caroom’s own storage, so listings without photographs still have a cover.
Authentication None
Vehicle make.
Vehicle model.
Source image URL.
1curl -X POST "https://2i4d72rogrhaqtyhxymk63aoj40pdypl.lambda-url.us-east-1.on.aws/" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "make": "Toyota",
5 "model": "Camry-L",
6 "url": "http://media.chromedata.com/MediaGallery/media/.../2013TOY003a_640_01.png"
7 }'Stores a set of stock images against a full make/model/trim/year. Send list: true with no photos to read back what is already stored instead of writing.
Authentication None
Vehicle make.
Vehicle model.
Trim level.
Body style.
Model year.
Primary image URL.
Additional image URLs.
Return the stored photos instead of writing new ones.
1curl -X POST "https://6lgff4jwcexog74mleeht4ktbq0iowly.lambda-url.us-east-1.on.aws/" \
2 -H "Content-Type: application/json" \
3 -d '{
4 "list": true,
5 "make": "BMW",
6 "style": "SUV",
7 "model": "X3",
8 "trim": "3.0si",
9 "year": "2008"
10 }'