VIN Decode
Resolve a VIN into normalized year, make, model, trim, body and powertrain fields.
Live APIDeveloper-first vehicle intelligence
Build with planned APIs for VIN identity, sale listings, market value, and depreciation—with separately priced vehicle reports when a workflow needs deeper coverage.
Request
curl --request GET \
"https://api.vehicles.dev/v1/vehicles/decode?vin=1HGCM82633A004352" \
--header "Authorization: Bearer $VEHICLES_API_KEY"200 · illustrative response
{
"data": {
"vin": "1HGCM82633A004352",
"year": 2003,
"make": "Honda",
"model": "Accord",
"trim": "EX"
},
"meta": {
"observed_at": "2026-08-01T00:00:00Z",
"dataset_version": "preview-2026-08"
}
}Illustrative schema only. Fields and availability may change before release.
01 / API catalog
10 focused product surfaces are being shaped into one consistent contract. Every endpoint below is a preview, not a claim of current availability.
Resolve a VIN into normalized year, make, model, trim, body and powertrain fields.
Retrieve normalized exterior and interior imagery for a resolved vehicle.
Query canonical dimensions, equipment, options and manufacturer specifications.
Match recalls and safety notices to a resolved vehicle with source timestamps.
Search normalized sale listings with price, mileage, location and observed-at fields.
Follow listing price changes, first-seen dates and removal signals over time.
Estimate retail and trade value with geography, mileage, confidence and model version.
Model value loss by age, mileage and forecast horizon with explicit assumptions.
Compare maintenance, operating and ownership-cost inputs without hiding the methodology.
Generate a coverage-checked Vehicles.dev report assembled from vehicle, market, safety and ownership data. Use GET /v1/reports/quote for a free coverage check before report generation.
02 / Methodology
The planned contract keeps observed facts, normalized records, and derived estimates distinct. That gives developers the context to decide where each answer belongs in their product.
Preserve when and where a listing, specification, or safety record was observed.
Resolve identifiers and units without erasing useful nulls or source timing.
Return valuation and depreciation assumptions beside the model version used.
Expose the geography, mileage, horizon, and observation window behind an output.
{
"value": { "amount": 28400, "currency": "USD" },
"basis": {
"geography": "US-MA",
"mileage": 38200,
"observations_through": "2026-08-01"
},
"model": {
"name": "market_value",
"version": "preview"
}
}Illustrative fields. Final names and formats will be documented before paid use.
03 / Pricing model
A platform tier sets access and throughput. Transparent usage rates cover the data work. The premium Vehicle Report API is metered separately from standard API calls.
Starter
No platform fee + usage fees
No annual platform fee + usage fees
Build and validate with core vehicle and marketplace data before paying a platform fee.
Start freePro
Most popularBilled monthly + usage fees
Billed $2,988 yearly + usage fees
Ship production automotive workflows with the complete intelligence toolkit.
Request 14-day trialScale
Billed monthly + usage fees
Billed $5,988 yearly + usage fees
Run higher-volume products with the lowest unit rates and full marketplace history.
Request Scale accessCompare usage
Only successful responses are billed. Authentication failures, rate-limit rejections, and server errors cost $0.
| Product / billing unit | Starter | Pro | Scale |
|---|---|---|---|
| Access | |||
| Monthly API callssuccessful responses / month | 1,000 core calls | Unlimited volume* | Unlimited volume* |
| Rate limitrequests / second | 5 / second | 10 / second | 50 / second |
| API price / unit | |||
| VIN Decodesuccessful lookup | Included, then $0.004 | $0.0025 | $0.0015 |
| Vehicle Listingssuccessful API call | Included, then $0.002 | $0.0015 | $0.001 |
| Vehicle Photossuccessful lookup | Included, then $0.001 | $0.0009 | $0.0007 |
| Specificationssuccessful lookup | Not included | $0.0015 | $0.001 |
| Recalls & Safetysuccessful lookup | Not included | $0.01 | $0.007 |
| Market Valuemodel estimate | Not included | $0.015 | $0.01 |
| Depreciationmodel forecast | Not included | $0.015 | $0.01 |
| Ownership Costsmodel estimate | Not included | $0.045 | $0.035 |
| Listing Historyhistory | Not included | Not included | $0.006 |
| Vehicle Report APIreport | Not included | $1.99 | $0.99 |
* Unlimited volume means no monthly call ceiling. Per-unit data fees still apply. Starter’s monthly allowance covers VIN Decode, Vehicle Listings, and Vehicle Photos; paid-plan APIs are excluded. Vehicle Report API access is limited to Pro and Scale.
04 / Questions
The catalog is in early access. These answers describe the product contract we are building, not operational endpoint guarantees.
Each response is designed to carry observation time, model or dataset version, and the coverage details needed to judge it.
Listings are normalized into our own observation model. Value and depreciation outputs are derived products with versioned assumptions, not copied source records.
No. Vehicle Report API is available on Pro and Scale and billed per successfully generated report at the tier rate. Coverage checks are free, unsupported VINs cost $0, and failed generations cost $0. Reports never consume standard API call quota.
Only responses that successfully complete the requested lookup are billed. Authentication failures, rate-limit rejections and server errors are not billable.
Standard plans cover use inside your product, not redistribution of raw records or resale as a standalone dataset. Bulk and redistribution rights require a separate agreement.
The catalog and launch rates are previews. We will confirm final pricing, coverage and release status before enabling a billable API key.
Early access / Vehicles.dev
Tell us which VIN, listing, valuation, depreciation, or report decision your product needs to make. We will be direct about fit, availability, and pricing.