VIN Decode
Resolve a VIN into normalized year, make, model, trim, body and powertrain fields.
Live APIDeveloper-first vehicle intelligence
Build with APIs for VIN identity, sale listings, market value, and depreciation—with account-owned, asynchronous vehicle history reports when a workflow needs deeper record coverage.
Request
curl --request GET \
"https://api.vehicles.dev/v1/vehicles/vin/1HGCM82633A004352" \
--header "Authorization: Bearer $VEHICLES_API_KEY"200 · application/json
{
"origin": "vpic",
"source": "vehicles.dev",
"vehicle": {
"year": 2003,
"make": "Honda",
"model": "Accord",
"trim": "EX-V6",
"body_style": "Coupe",
"fuel": "Gasoline",
"transmission": "Automatic",
"cylinders": 6,
"doors": 2,
"engine": "3.0L V-Shaped 6cyl"
},
"vin": "1HGCM82633A004352"
}Live response shape. Optional vehicle fields vary with source coverage.
01 / API catalog
All twelve synchronous APIs plus the Vehicle History Report workflow are available now through one consistent contract. Browse all vehicle data APIs →
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.
Estimate retail and trade value with geography, mileage, confidence and model version.
Rate an asking price with a market-value gap, deal label, supply context and price history.
Model value loss by age, mileage and forecast horizon with explicit assumptions.
Compare maintenance, operating and ownership-cost inputs without hiding the methodology.
Model five-year cost across depreciation, fuel, upkeep, tax and finance, labelling every assumption.
Amortize an auto loan into payment, total interest and a per-year split, negative equity included.
Estimate purchase tax with the per-state trade-in rule, plus title, registration and doc fees.
Order an account-owned vehicle history report by VIN, poll its status, and retrieve the available canonical JSON result.
02 / Methodology
The live 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.
{
"currency": "USD",
"estimateUsd": 26096,
"inputs": {
"year": 2021,
"make": "Toyota",
"model": "Camry",
"trim": "SE",
"miles": 45000,
"state": "TX"
},
"medianApePct": 6.0,
"source": "vehicles.dev"
}Representative live fields. Exact values and optional inputs vary by request.
03 / Pricing model
A platform tier sets access and throughput. Transparent usage rates cover the data work. The Vehicle History Report API is metered separately from standard API calls.
Starter
No platform fee + usage fees
No annual platform fee + usage fees
Build with eleven included vehicle data APIs on a one-time free allowance; add prepaid credits when needed.
Start freePro
Most popularBilled monthly + usage fees
Billed $2,988 yearly + usage fees
Ship production automotive workflows with the complete intelligence toolkit.
Get ProGet ProScale
Billed monthly + usage fees
Billed $5,988 yearly + usage fees
Run higher-volume products with the lowest unit rates and throughput.
Get ScaleGet ScaleCompare usage
Only successful responses are billed. Authentication failures, rate-limit rejections, and server errors cost $0.
| Product / billing unit | Starter | Pro | Scale |
|---|---|---|---|
| Access | |||
| Included API callssuccessful responses, one-time on Starter | 250 included 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 | Included, then $0.0015 | $0.0015 | $0.001 |
| Recalls & Safetysuccessful lookup | Included, then $0.01 | $0.01 | $0.007 |
| Market Valuemodel estimate | Included, then $0.015 | $0.015 | $0.01 |
| Price Check & Deal Ratingassessment | Credit only, $0.015 | $0.015 | $0.01 |
| Depreciationmodel forecast | Included, then $0.015 | $0.015 | $0.01 |
| Ownership Costsmodel estimate | Included, then $0.045 | $0.045 | $0.035 |
| Vehicle History Reportreport | Not available | $1.99 | $0.99 |
* Unlimited volume means no monthly call ceiling. Per-unit data fees still apply. Starter’s monthly allowance is shared across eleven included-call vehicle data APIs; Price Check requires prepaid credits from the first call. After the allowance is used, other successful calls also draw from available credits at the published Starter rates. Vehicle History Reports require Pro or Scale and are billed separately.
04 / Questions
All twelve synchronous vehicle data APIs and the Vehicle History Report API are available now. The answers below explain billing, access, and coverage.
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 History Report API is available on Pro and Scale and billed when a report completes. Starter accounts receive 403 plan_upgrade_required and must upgrade before ordering. Unsupported VINs, action-required outcomes, and failed generations cost $0. Reports never consume standard API call quota, and missing sections in a completed result mean unavailable rather than clean.
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.
All twelve synchronous vehicle data APIs and the Vehicle History Report API are available now. Published catalog rates are active: successful synchronous responses are metered, and completed history reports are billed separately on Pro and Scale.
Production API / 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.