PlateToVIN API
A single, predictable REST API for US vehicle data. Turn a license plate into a VIN, read a plate straight from a photo, decode a VIN into a full specification, check open safety recalls and the problems owners report, and serve catalog-grade vehicle images — all with plain HTTP and JSON. No SDK required.
Authentication
The JSON endpoints (License Plate to VIN and VIN Decoding) authenticate with an
API key sent in the Authorization
header. You can find your key on your
API Keys page after signing in.
Authorization: sk_live_your_api_key_here
Base URL
All JSON endpoints live under a single HTTPS base. The Vehicle Images API is served from a dedicated image host.
https://platetovin.com/api
https://vehicle-images.platetovin.com
Quickstart
Convert your first license plate to a VIN in one request. Replace the API key with your own, then switch languages on the right.
curl https://platetovin.com/api/convert \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"state": "CA", "plate": "7ABC123"}'
const res = await fetch('https://platetovin.com/api/convert', {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json',
'Accept': 'application/json',
},
body: JSON.stringify({ state: 'CA', plate: '7ABC123' }),
});
const data = await res.json();
console.log(data.vin);
$res = Http::withHeaders(['Authorization' => 'YOUR_API_KEY'])
->acceptJson()
->post('https://platetovin.com/api/convert', [
'state' => 'CA',
'plate' => '7ABC123',
]);
$vin = $res->json('vin');
import requests
res = requests.post(
'https://platetovin.com/api/convert',
headers={'Authorization': 'YOUR_API_KEY', 'Accept': 'application/json'},
json={'state': 'CA', 'plate': '7ABC123'},
)
print(res.json()['vin'])
License Plate to VIN
/api/convert
Convert a single US license plate and state into a VIN, along with a quick decode of the core vehicle attributes (make, model, year, trim, engine and more).
Body parameters
plate
string
required
7ABC123.state
string
required
CA, TX, NY.Response fields
success
boolean
vin
object
vin
string
name
string
2011 Mercedes-Benz M-Class.year
string
make
string
Mercedes-Benz.model
string
M-Class.trim
string
ML 350.style
string
SUV, Sedan.engine
string
3.5L V6 DOHC 24V.fuel
string
Gasoline.driveType
string
AWD, FWD.transmission
string
Automatic.GVWR
integer|string
Class 3: 10,001 - 14,000 lb. null when unavailable.color
object
name
string
Silver.abbreviation
string
SIL.curl https://platetovin.com/api/convert \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"state": "CA", "plate": "7ABC123"}'
await fetch('https://platetovin.com/api/convert', {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ state: 'CA', plate: '7ABC123' }),
});
{
"success": true,
"vin": {
"vin": "4JGBB8GB9BA648907",
"name": "2011 Mercedes-Benz M-Class",
"year": "2011",
"make": "Mercedes-Benz",
"model": "M-Class",
"trim": "ML 350",
"style": "SUV",
"engine": "3.5L V6 DOHC 24V",
"fuel": "Gasoline",
"driveType": "AWD",
"transmission": "Automatic",
"GVWR": 6063,
"color": { "name": "Silver", "abbreviation": "SIL" }
}
}
License Plate OCR
/api/ocr
Read a US license plate from a photo. We detect the plate in the scene (full photos are fine — no cropping needed), read the characters, correct them against the issuing state's plate format, and return the serial with a ranked list of candidate states, per-character confidences and the bounding box — everything you need to build your own capture or review flow. Uploaded images are never stored.
OCR never runs a VIN lookup by itself. When you want the VIN, take plate
and state.code from a trusted read and call
License Plate to VIN — and if that misses, retry with the
next state_candidates entries, using each candidate's own plate
value.
trusted before looking up.
Blurry or uncertain reads come back as low_confidence with the best
guess marked trusted: false — treat those as suggestions to confirm,
not as input for a plate lookup.
Body parameters
image
string | file
required
data: URIs accepted) in a JSON body, or a multipart file upload in the image field.state_suggestions
string[]
["NJ", "NY"] for a camera in New Jersey near the NY border. Strongly improves accuracy. It's a prior, not a filter: strong visual evidence for another state still wins. A comma-separated string ("NJ,NY") also works; unknown codes are ignored and echoed back in ignored_suggestions.Statuses
ok
status
plate carries trusted: true and is safe to feed into License Plate to VIN.low_confidence
status
plate holds the best guess with trusted: false — treat it as a suggestion and re-shoot if you can.no_plate_found
status
non_us_plate
status
Response fields
success
boolean
status
string
request_id
string
image
object
width, height) — the coordinate space for bbox.plate
object
null when status is no_plate_found.plate
string
plate_display
string
ZZC-31V.confidence
float
char_confidences
float[]
plate.bbox
int[]
[x_min, y_min, x_max, y_max].detection_confidence
float
state
object
code
string
name
string
New Jersey.confidence
float
state_candidates
object[]
plate — the serial as corrected under that state's format, occasionally differing by a character. When a plate lookup misses under the top state, retry with these, highest confidence first.code · name · confidence
mixed
state.plate
string
plate_type
string
passenger, commercial, motorcycle, … or vanity_or_unrecognized.is_vanity_likely
boolean
true when the plate looks personalized. Vanity plates are real registrations and still resolve to VINs.warnings
string[]
low_text_confidence, low_state_confidence, possibly_non_us_plate: <region>. Empty for clean reads.trusted
boolean
additional_plates
object[]
plate.ignored_suggestions
string[]
state_suggestions that aren't valid jurisdiction codes.Billing
Plans include a monthly OCR call allowance (unlimited on enterprise). Once it's used up,
additional calls are billed per call from your account balance at your plan's overage
rate — or refused with a 403 on plans without overage. Every processed image
counts, whatever its status; rejected uploads and service errors don't. OCR itself never
triggers a plate lookup — resolving a VIN through
/api/convert is a separate call, billed as usual.
curl https://platetovin.com/api/ocr \
-H "Authorization: YOUR_API_KEY" \
-F "[email protected]" \
-F "state_suggestions=NJ,NY"
curl https://platetovin.com/api/ocr \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "'$(base64 -i driveway.jpg)'",
"state_suggestions": ["NJ", "NY"]
}'
const form = new FormData();
form.append('image', fileInput.files[0]);
form.append('state_suggestions', 'NJ,NY');
const res = await fetch('https://platetovin.com/api/ocr', {
method: 'POST',
headers: { 'Authorization': 'YOUR_API_KEY' },
body: form,
});
const data = await res.json();
if (data.status === 'ok') {
// Trusted read — resolve the VIN with /api/convert when you need it
const { plate, state } = data.plate;
console.log(plate, state.code);
}
{
"success": true,
"status": "ok",
"request_id": "9e177840deec",
"image": { "width": 3913, "height": 2678 },
"plate": {
"plate": "ZZC31V",
"plate_display": "ZZC-31V",
"confidence": 0.985,
"char_confidences": [0.999, 0.999, 0.996, 0.996, 0.999, 0.995],
"bbox": [2690, 1753, 3076, 2059],
"detection_confidence": 0.91,
"state": {
"code": "NJ",
"name": "New Jersey",
"confidence": 0.98
},
"state_candidates": [
{ "code": "NJ", "name": "New Jersey", "confidence": 0.98, "plate": "ZZC31V" },
{ "code": "NY", "name": "New York", "confidence": 0.01, "plate": "ZZC31V" }
],
"plate_type": "passenger",
"is_vanity_likely": false,
"warnings": [],
"trusted": true
}
}
{
"success": true,
"status": "low_confidence",
"request_id": "b41c09aa77f2",
"image": { "width": 1920, "height": 1080 },
"plate": {
"plate": "8XK4O2",
"plate_display": "8XK4O2",
"confidence": 0.41,
"char_confidences": [0.93, 0.88, 0.52, 0.61, 0.22, 0.35],
"bbox": [811, 540, 1004, 634],
"detection_confidence": 0.87,
"state": { "code": "CA", "name": "California", "confidence": 0.44 },
"state_candidates": [
{ "code": "CA", "name": "California", "confidence": 0.44, "plate": "8XK4O2" },
{ "code": "AZ", "name": "Arizona", "confidence": 0.21, "plate": "8XK402" }
],
"plate_type": "passenger",
"is_vanity_likely": false,
"warnings": ["low_text_confidence", "low_state_confidence"],
"trusted": false
}
}
VIN Decoding
/api/vin-lookup
Decode a VIN into a complete vehicle specification: engine & drivetrain, performance, economy, dimensions, warranty, colors and standard/optional features. Requires a plan that includes VIN decoding.
Body parameters
vin
string
required
WBAAV53431JR78115.Response object groups
data contains the full specification. Depending on
coverage for the vehicle, it may include the following nested objects — fields without
data for a given vehicle are null:
year · make · model · trim · body_type
string
trim_description · platform_code · domestic_import · manufacturer_country
string
330i Rwd 4dr Sedan (3.0L 6cyl 5M), E46, Imported, Germany.msrp · base_invoice
number
engine_drivetrain
object
cylinder_layout
string
I6, V8.engine_displacement
number
engine_type
string
gas, diesel, hybrid, electric.fuel_type
string
premium unleaded (required).valves
integer
valve_timing
string
Variable.cam_type
string
Double overhead cam (DOHC).drivetrain
string
rear wheel drive, all wheel drive.transmission
string
5-speed manual, Automatic.performance
object
horsepower
integer
horsepower_rpm
integer
torque
integer
torque_rpm
integer
zero_to_sixty_time
number
economy
object
fuel_tank_size
number
mpg_city
integer
mpg_highway
integer
mpg_combined
integer
range_city
integer
range_highway
integer
range_combined
integer
body
object
gross_weight
integer|string
Class 3: 10,001 - 14,000 lb.curb_weight
integer
length
integer
width
integer
height
integer
wheelbase
integer
ground_clearance
number
turning_circle
number
doors
integer
seats
integer
towing_capacity
integer
warranty
object
4 yr./ 50000 mi.basic
string
drivetrain
string
roadside
string
rust
string
colors
object
exterior
object
"R,G,B" value, e.g. "Jet Black": "0,0,0".interior
object
"R,G,B" value.features
object
suspension
string[]
front_seats
string[]
rear_seats
string[]
features
string[]
safety
string[]
curl https://platetovin.com/api/vin-lookup \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vin": "WBAAV53431JR78115"}'
await fetch('https://platetovin.com/api/vin-lookup', {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ vin: 'WBAAV53431JR78115' }),
});
{
"success": true,
"data": {
"year": "2001",
"make": "BMW",
"model": "3 Series",
"trim": "330i - Sedan",
"trim_description": "330i Rwd 4dr Sedan (3.0L 6cyl 5M)",
"body_type": "Sedan",
"msrp": 33990,
"base_invoice": 30750,
"domestic_import": "Imported",
"manufacturer_country": "Germany",
"platform_code": "E46",
"engine_drivetrain": {
"cylinder_layout": "I6",
"engine_displacement": 3,
"engine_type": "gas",
"fuel_type": "premium unleaded (required)",
"valves": 24,
"valve_timing": "Variable",
"cam_type": "Double overhead cam (DOHC)",
"drivetrain": "rear wheel drive",
"transmission": "5-speed manual"
},
"performance": {
"horsepower": 225,
"horsepower_rpm": 5900,
"torque": 214,
"torque_rpm": 3500,
"zero_to_sixty_time": 4.76
},
"economy": {
"fuel_tank_size": 16.6,
"mpg_city": 18,
"mpg_highway": 27,
"mpg_combined": 22,
"range_city": 298,
"range_highway": 448,
"range_combined": 366
},
"body": {
"gross_weight": 3931,
"curb_weight": 3318,
"length": 176,
"width": 68,
"height": 55,
"wheelbase": 107,
"ground_clearance": null,
"turning_circle": 34,
"doors": null,
"seats": 5,
"towing_capacity": 1000
},
"warranty": {
"basic": "4 yr./ 50000 mi.",
"drivetrain": "4 yr./ 50000 mi.",
"roadside": null,
"rust": null
},
"colors": {
"exterior": {
"Steel Gray Metallic": "60,60,65",
"Orient Blue Metallic": "30,94,130",
"Jet Black": "0,0,0",
"Alpine White": "255,255,255",
"Bright Red": "159,14,5",
"Titanium Silver Metallic": "171,172,175"
},
"interior": {
"Sand": "191,147,98",
"Gray": "134,143,142",
"Black": "0,0,0"
}
},
"features": {
"suspension": ["Four-wheel independent suspension"],
"front_seats": ["Bucket front seats", "Vinyl"],
"rear_seats": ["Split-folding rear seatback"],
"features": [
"1 one-touch power windows",
"Remote keyless power door locks",
"Heated mirrors",
"Power mirrors"
],
"safety": [
"Child seat anchors",
"Daytime running lights",
"Dual front side-mounted airbags",
"Engine immobilizer",
"Stability control",
"Traction control",
"4-wheel ABS"
]
}
}
}
Safety Recalls
/api/recalls
Look up open NHTSA safety recall campaigns for a vehicle. Send a VIN and we decode it in-house, then return every recall campaign filed for that year, make and model — newest first. You can also query by year, make and model directly.
Recall lookups are free per call on plans that include them — they never consume credit and have no monthly cap.
Body parameters
vin
string
required
1FTFW1ED0MFA63198. Not required when make, model and year are supplied instead.make
string
Ford. Required together with model and year when vin is omitted.model
string
F-150. Required together with make and year when vin is omitted.year
integer
2021. Required together with make and model when vin is omitted.Response fields
success
boolean
data
object
vin
string
null when querying by make/model/year.year · make · model
string
count
integer
0 with an empty recalls array means no recalls on file.recalls
object[]
campaign_number
string
22V412000.report_date
string
YYYY-MM-DD.component
string
SEAT BELTS.summary
string
consequence
string
remedy
string
notes
string
manufacturer
string
Ford Motor Company.park_it
boolean
true when NHTSA advises the vehicle should not be driven.park_outside
boolean
true when NHTSA advises parking outdoors due to fire risk.over_the_air_update
boolean
true when the remedy is delivered as an over-the-air update.curl https://platetovin.com/api/recalls \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vin": "1FTFW1ED0MFA63198"}'
await fetch('https://platetovin.com/api/recalls', {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ vin: '1FTFW1ED0MFA63198' }),
});
{
"success": true,
"data": {
"vin": "1FTFW1ED0MFA63198",
"year": 2021,
"make": "Ford",
"model": "F-150",
"count": 2,
"recalls": [
{
"campaign_number": "22V412000",
"report_date": "2022-06-08",
"component": "SEAT BELTS",
"summary": "Ford Motor Company (Ford) is recalling certain 2021 F-150 vehicles. The front seat belt buckle assembly may be improperly secured.",
"consequence": "A seat belt that does not properly restrain the occupant increases the risk of injury in a crash.",
"remedy": "Dealers will inspect and replace the seat belt buckle assembly as necessary, free of charge.",
"notes": "Owners may also contact the NHTSA Vehicle Safety Hotline at 1-888-327-4236.",
"manufacturer": "Ford Motor Company",
"park_it": false,
"park_outside": false,
"over_the_air_update": false
},
{
"campaign_number": "21V576000",
"report_date": "2021-07-28",
"component": "ELECTRICAL SYSTEM",
"summary": "...",
"consequence": "...",
"remedy": "...",
"notes": "...",
"manufacturer": "Ford Motor Company",
"park_it": false,
"park_outside": false,
"over_the_air_update": true
}
]
}
}
Vehicle Issues
/api/vehicle-issues
What to look out for on a used car at its mileage — ready to drop into a vehicle history report, inspection checklist or underwriting screen. We group every owner complaint filed with NHTSA into named problems per make and model, learn the mileage each one is usually reported at, and sort this vehicle's problems into four lists:
watch_now— commonly reported around this mileage.coming_up— usually reported later, soonest first.check_was_fixed— usually reported earlier in the car's life: ask whether it was dealt with. Problems the manufacturer issued a fix for come first.any_mileage— no clear mileage pattern.
Every problem comes with plain-English what_to_check (what an inspector or buyer
can look for) and ask_the_seller (the question to ask, naming the manufacturer's
bulletin or warranty extension where there is one), plus a headline paragraph
summarising the lot. Send the odometer reading as mileage; without it we estimate
from the vehicle's age.
Send a VIN for the most precise answer: we match complaints from vehicles with the same model line, body and engine (VIN positions 4–8) and model year, and fall back to the whole model year when that trim has too few reports. You can also query by year, make and model. Vehicle issue lookups are free and unlimited on plans that include them.
Issues are built from owner-reported complaints.
NHTSA does not verify them, and a reported issue is not a confirmed defect — present it
to your users as "owners report". Data is rebuilt weekly; data_through
is the date of the newest complaint included.
Guidance text (title, what_to_check, ask_the_seller,
manufacturer_fix.summary) is written by an AI model from the complaints and
the manufacturer's own communications. Check the linked documents before relying on a
specific bulletin number.
vs_similar_vehicles uses vehicles-on-the-road counts from Washington State Department
of Licensing registration data, made available under the
Open Database License.
Body parameters
vin
string
required
2HKRW2H86HH123456. Not required when make, model and year are supplied instead.make
string
Honda. Required together with model and year when vin is omitted.model
string
CR-V. Required together with make and year when vin is omitted.year
integer
2017. Required together with make and model when vin is omitted.mileage
integer
72000. Decides which list each problem lands in. When omitted we estimate it from the model year (12,000 miles a year) and say so in mileage.source.level
string
trim (default with a VIN) or year to count every complaint for the model year. Year/make/model queries are always answered at year level.limit
integer
10, maximum 50.Response fields
success
boolean
data
object
vehicle
object
vin, year, make, model, and — for VIN lookups — the decoded trim and engine.level
string
trim or year: which complaints the counts are drawn from. A VIN falls back to year when its trim has fewer than 10 reports.data_through
string
YYYY-MM-DD.mileage
object
value used to sort the lists and its source: provided or estimated.headline
string
summary
object
issues and owner_reports across every problem, how many are safety_related, and how many are in each list. Counts include problems beyond limit.watch_now
object[]
coming_up
object[]
check_was_fixed
object[]
any_mileage
object[]
id
string
honda-cr-v-engine-oil-2. Unchanged between weekly rebuilds.title
string
short_name
string
fuel in the engine oil.summary
string
null for a newly found problem.category
object
id, name, group), identical across every vehicle. vs_similar_vehicles: this model year's complaint rate in the category against every vehicle of the same model year, per vehicle on the road — 1.0 is average, 3.0 three times average, null when there are too few registrations to rate.safety_related
boolean
owner_reports
object
matching_vehicles (at level), the whole model_year, and all_years of the model.reported_at
object
from (25th percentile), median, to (75th percentile), sample_size. null when there is no clear pattern. Owners report most while a car is new, so read this as when problems are reported, not a failure rate.what_to_check
string
ask_the_seller
string
manufacturer_fix
object
status: warranty_extension, fix_available, investigating, acknowledged or none. summary: one sentence on the remedy, or null. documents: up to 3 matching communications, each with type (warranty_extension, service_bulletin, software_update, service_campaign, owner_letter, dealer_message, other), the manufacturer's id, date, title and an NHTSA url.severity
object
crashes, fires, injuries and deaths.merged_issues
string[]
evidence
object
nhtsa_complaints: up to 5 of the most recent NHTSA complaint (ODI) numbers behind it.curl https://platetovin.com/api/vehicle-issues \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vin": "2HKRW2H86HH123456", "mileage": 72000, "limit": 1}'
await fetch('https://platetovin.com/api/vehicle-issues', {
method: 'POST',
headers: {
'Authorization': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ vin: '2HKRW2H86HH123456', mileage: 72000, limit: 1 }),
});
curl https://platetovin.com/api/vehicle-issues \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year": 2017, "make": "Honda", "model": "CR-V", "mileage": 72000, "limit": 5}'
{
"success": true,
"data": {
"vehicle": {
"vin": "2HKRW2H86HH123456",
"year": 2017,
"make": "Honda",
"model": "CR-V",
"trim": "EX-L/EX-L Navi",
"engine": "1.5L 4-cyl gasoline"
},
"level": "trim",
"data_through": "2026-10-26",
"mileage": {
"value": 72000,
"source": "provided"
},
"headline": "At 72,000 miles, owners of the 2017 Honda CR-V most often report fuel injector failure, fuel pump failure and cold start rattle around this point. Coming up: head gasket failure, usually reported from about 73,000 miles. Earlier in its life it was known for phantom automatic braking and fuel in the engine oil, which the manufacturer issued fixes for: ask for proof the work was done. At any mileage, owners also report engine stalling.",
"summary": {
"issues": 22,
"owner_reports": 437,
"safety_related": 8,
"watch_now": 3,
"coming_up": 1,
"check_was_fixed": 12,
"any_mileage": 6
},
"watch_now": [
{
"id": "honda-cr-v-fuel-system-2",
"title": "Dashboard warning lights and hard starting from fuel injector failure",
"short_name": "fuel injector failure",
"summary": "Owners report multiple dashboard warning lights appearing, sometimes intermittently, along with difficulty starting, no-start, or stumbling. The check engine light may come on with a low fuel pressure code.",
"category": {
"id": "fuel_system",
"name": "Fuel system",
"group": "powertrain",
"vs_similar_vehicles": 5.88
},
"safety_related": false,
"owner_reports": {
"matching_vehicles": 29,
"model_year": 101,
"all_years": 253
},
"reported_at": {
"from": 50500,
"median": 65238,
"to": 89826,
"sample_size": 119
},
"what_to_check": "Check for stored diagnostic trouble code P0087 (fuel rail pressure too low). On a test drive, note if the engine is hard to start or stumbles. Listen for unusual engine behavior.",
"ask_the_seller": "Have the fuel injectors been replaced, and if so, was the repair covered under any warranty or goodwill program?",
"manufacturer_fix": {
"status": "none",
"summary": null,
"documents": []
},
"severity": {
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0
},
"merged_issues": [],
"evidence": {
"nhtsa_complaints": [
"11750874",
"11750613",
"11740681",
"11730570",
"11725617"
]
}
}
],
"coming_up": [
{
"id": "honda-cr-v-engine-cooling",
"title": "Engine overheats, loses coolant, and misfires",
"short_name": "head gasket failure",
"summary": "Owners report sudden overheating, coolant loss, and rough running or misfires. The temperature gauge may spike and coolant disappears without visible leaks.",
"category": {
"id": "engine_cooling",
"name": "Cooling system and overheating",
"group": "powertrain",
"vs_similar_vehicles": 0.22
},
"safety_related": false,
"owner_reports": {
"matching_vehicles": 6,
"model_year": 22,
"all_years": 84
},
"reported_at": {
"from": 72550,
"median": 89000,
"to": 111322,
"sample_size": 47
},
"what_to_check": "Check coolant level and condition; look for white smoke from exhaust or milky oil on dipstick. On a test drive, monitor temperature gauge for erratic behavior and listen for rough idle or misfire.",
"ask_the_seller": "Ask if the cylinder head gasket was replaced under Service Bulletin A26-016 and if the repair included the updated gasket and any related software update.",
"manufacturer_fix": {
"status": "fix_available",
"summary": "Honda Service Bulletin A26-016 describes replacing the cylinder head gasket with an improved part to address reduced gasket effectiveness that can cause overheating, coolant loss, and misfire.",
"documents": [
{
"type": "service_bulletin",
"id": "A26-016",
"date": "2026-09-25",
"title": "Under certain conditions, the cylinder head gasket effectiveness may be reduced which may cause vehicles to experience overheating, coolant loss, and/or misfire.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=11037702"
},
{
"type": "dealer_message",
"id": "AEBM08262026901",
"date": "2026-08-26",
"title": "Under certain conditions, the cylinder head gasket effectiveness may be reduced which may cause vehicles to experience overheating, coolant loss, misfire, and/or DTCs P0300 through P0304 stored.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=11036424"
},
{
"type": "service_bulletin",
"id": "A26-016",
"date": "2026-08-26",
"title": "Under certain conditions, the cylinder head gasket effectiveness may be reduced which may cause vehicles to experience overheating, coolant loss, misfire and/or DTCs P0300 thru P0304 stored.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=11036413"
}
]
},
"severity": {
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0
},
"merged_issues": [],
"evidence": {
"nhtsa_complaints": [
"11753636",
"11730975",
"11729121",
"11659391",
"11656996"
]
}
}
],
"check_was_fixed": [
{
"id": "honda-cr-v-park-shifter",
"title": "Shift knob button breaks and pops out",
"short_name": "broken shift button",
"summary": "Owners report the shift knob button breaking and popping out, often while shifting into or out of park. This can make it difficult or impossible to move the gear selector.",
"category": {
"id": "park_shifter",
"name": "Park, shifter and rollaway",
"group": "powertrain",
"vs_similar_vehicles": 2.06
},
"safety_related": true,
"owner_reports": {
"matching_vehicles": 42,
"model_year": 156,
"all_years": 179
},
"reported_at": {
"from": 12750,
"median": 22806,
"to": 36250,
"sample_size": 136
},
"what_to_check": "Check the shift knob button for cracks or looseness. Try pressing it firmly while shifting; if it feels brittle or moves abnormally, it may be failing.",
"ask_the_seller": "Ask if the product update for the shift knob button (referenced in owner notification letters) has been completed.",
"manufacturer_fix": {
"status": "fix_available",
"summary": "Honda issued a product update to replace the shift knob with a revised part made of a different material that is less susceptible to breakage from heat and humidity.",
"documents": [
{
"type": "owner_letter",
"id": "ONL6DK07232019",
"date": "2019-07-23",
"title": "On some CR-V models, the material that the shift button is made of is susceptible to heat and humidity and may break.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=10163451"
},
{
"type": "service_bulletin",
"id": "A19-063",
"date": "2019-05-29",
"title": "The shift knob button is susceptible to breakage after being exposed to heat and humidity.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=10160912"
},
{
"type": "owner_letter",
"id": "ONLE5007192021",
"date": "2021-07-19",
"title": "Our records indicate that a PRODUCT UPDATE has not been completed on this vehicle (Vehicle Identification Number XXXXXXXXXXXXXXXXX).",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=10199468"
}
]
},
"severity": {
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0
},
"merged_issues": [
"honda-cr-v-seats-interior-2"
],
"evidence": {
"nhtsa_complaints": [
"11551328",
"11493449",
"11484907",
"11474998",
"11468845"
]
}
}
],
"any_mileage": [
{
"id": "honda-cr-v-engine-stall-power",
"title": "Engine stalls without warning while driving",
"short_name": "engine stalling",
"summary": "Owners report the engine suddenly stalls or loses power while driving at various speeds, including on the highway and at stoplights. The failure occurs without warning and may be intermittent, sometimes restarting after pressing the accelerator.",
"category": {
"id": "engine_stall_power",
"name": "Stalling or loss of power",
"group": "powertrain",
"vs_similar_vehicles": 0.74
},
"safety_related": true,
"owner_reports": {
"matching_vehicles": 17,
"model_year": 79,
"all_years": 545
},
"reported_at": null,
"what_to_check": "On a test drive, accelerate from a stop and at highway speeds to see if the engine hesitates, loses power, or stalls. Check for any stored diagnostic trouble codes with an OBD-II scanner.",
"ask_the_seller": "Ask if the stalling issue has ever occurred and whether any repairs or diagnostic work were performed.",
"manufacturer_fix": {
"status": "fix_available",
"summary": null,
"documents": [
{
"type": "owner_letter",
"id": "CL_6DU_12172018",
"date": "2018-12-17",
"title": "On 2017-18 CR-V vehicles equipped with the 1.5 liter turbocharged engine, there are reports of vehicles experiencing drivability concerns.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=10152444"
},
{
"type": "service_bulletin",
"id": "ONL6DU02102020",
"date": "2020-02-10",
"title": "Followup Notice - Our records indicate that a PRODUCT UPDATE has not been completed on this vehicle; refer to the address card for the affected VIN.",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=10171554"
},
{
"type": "dealer_message",
"id": "ATI&08262024902",
"date": "2024-08-26",
"title": "American Honda Motor Co., Inc. (AHM) is searching for certain 2018-2022 Accord FHEVs, as well as 2017-2022 CR-V 1.5Ls (no 2.4L), & 2020-2022 CR-V FHEVs with a customer complaint of the Malfunction…",
"url": "https://www.nhtsa.gov/vehicle/manufacturer-communications?nhtsaId=11006807"
}
]
},
"severity": {
"crashes": 0,
"fires": 0,
"injuries": 0,
"deaths": 0
},
"merged_issues": [
"honda-cr-v-turbo",
"honda-cr-v-hybrid-ev-battery",
"honda-cr-v-engine-stall-power-2"
],
"evidence": {
"nhtsa_complaints": [
"11755149",
"11749795",
"11744566",
"11618994",
"11579535"
]
}
}
]
}
}
Vehicle Images
vehicle-images.platetovin.com/image
Serve catalog-grade vehicle images straight from an <img> tag. Every
image is a transparent PNG rendered at a fixed, consistent framing so vehicles line up
perfectly across a page. Five angles, six colors, three sizes — all from one HTTP GET.
Referer of the whitelisted domains
on your account. Add your domains in your dashboard, then hotlink the URLs directly.
tier=free to any request for the public watermarked preview — front angle,
low-resolution, no referer or key required — or browse and download previews from the
image library. A vehicle
without a generated preview returns 404.
Query parameters
search
string
required
BMW 3 Series. Matching resolves make, model and generation server-side.year
integer
required
2022. Years newer than our latest imagery fall back to the closest available model year, so current-generation vehicles always render.angle
string
front, front_angle, side, rear, rear_angle. Defaults to front_angle.color
string
base, silver, black, white, gray, red. Defaults to base.size
string
large, medium, small. Defaults to large.tier
string
free for the public, no-auth watermarked preview — front angle only, low-resolution, with a forced background. All other parameters are ignored; a vehicle without a generated preview returns 404. Omit for licensed full-resolution images.Want the full walkthrough with a live playground? See the Vehicle Images page →
<img
src="https://vehicle-images.platetovin.com/image?search=BMW+3+Series&year=2022&angle=front_angle&color=red"
alt="2022 BMW 3 Series"
/>
Errors
The JSON API returns a consistent shape on failure — success: false
with a human-readable message — alongside a standard HTTP status code.
| Status | Meaning |
|---|---|
200 |
Success. Note: validation failures may also return 200 with success: false — always check the success flag. |
402 |
Payment required — your account balance is too low to run the lookup. Top up or enable auto-deposit. |
403 |
Forbidden — no billing plan assigned, the account is suspended, your plan doesn't include this endpoint (e.g. VIN decoding), or a monthly limit was reached on a plan without overage. |
404 |
No result found for the supplied plate or VIN. |
413 |
The uploaded image exceeds the 15 MB limit (OCR). Downscale or re-encode it. |
422 |
The upload couldn't be decoded as an image (OCR). |
503 |
The service behind this endpoint is temporarily unavailable — safe to retry shortly. |
{
"success": false,
"message": "Not enough credit"
}
Billing & limits
API access requires an active billing plan. License plate lookups are billed per request and cached for seven days — repeated lookups of the same plate within that window are free. VIN decoding and vehicle images are included on the plans that offer them, up to any monthly ceiling on your tier. Safety recall lookups are free per call on plans that include them — no credit charge and no monthly cap. Vehicle issue lookups are free and unlimited on the plans that include them (Enterprise).
License plate OCR comes with a monthly call allowance per plan (unlimited on enterprise). Past the allowance, calls are billed individually from your balance at your plan's overage rate; plans without an overage rate pause OCR until the allowance resets. OCR never runs a plate lookup itself — resolving a read to a VIN is a separate /api/convert call, billed as usual.
Pick a plan or create an account to get your API key.