VIN Insights API
Understand a vehicle’s market value, potential depreciation, and remaining lifespan.
Vehicle data you can put to work
Send one or more vehicle identification numbers (VINs) from your system. Get available estimates back to enrich listings, evaluate inventory, or support vehicle research.
Three kinds of insight. One request.
Our VIN Insights API provides the following data points for a given VIN:
Market Value
- Calculates fair market value by analyzing comparable vehicles currently and historically for sale in the local market.
- Powered by a database of over 20 billion data points, our proprietary model accounts for localized pricing trends, odometer readings, trim levels, and available features/options.
Projected Depreciation and Retention
- Forecasts vehicle value loss and retention curves across 3-year and 5-year horizons.
- Trained across millions of new and used vehicles and refreshed monthly. We synthesize historical depreciation trends, mileage accumulation curves, and broader market shifts to model residual value over time.
Remaining Lifespan of a New or Used Vehicle
- Estimates the remaining reliable service life of the vehicle, expressed in both remaining miles and years.
- Powered by proprietary longevity modeling developed across 400 million vehicles, incorporating real-world mileage patterns and vehicle survival trends to estimate remaining service life.
Choose the insights you need for up to 50 vehicles per request.
| Endpoint | What it does | Data returned |
|---|---|---|
Get VIN insightsPOST /api/data/v1/vin-insights |
Looks up one or more vehicles and returns the selected insights for each vehicle configuration. | Market value, depreciation, and/or remaining lifespan, with a status for each product. |
| Insight | What it tells you | Data returned when available |
|---|---|---|
Market valuemarket_value |
An estimated current value for a vehicle. | A value in US dollars and the mileage used, when known. |
Depreciationdepreciation |
How much value a vehicle is projected to lose over three and five years. | Loss rates and, when a starting price is available, dollar amounts. |
Remaining lifespanremaining_lifespan |
An estimate of how much life a vehicle has left. | Remaining years, miles, or both. |
What do I need to provide?
Start with a VIN for each vehicle. Optional details help tailor the result. You also need API access and an API key; our team can help you get started.
For the request
| Input name | What it means | Required | Example |
|---|---|---|---|
| Vehicles | The list of vehicles to evaluate, from 1 to 50 per request. | Yes | [{"vin": "19XFB2F59EE013816"}] |
| Insights to return | Select one or more of the three products. If omitted, the API selects the products enabled for your account. | No | ["market_value"] |
For each vehicle
| Input name | What it means | Required | Example |
|---|---|---|---|
| VIN | The vehicle’s 17-character identification number. | Yes | "19XFB2F59EE013816" |
| Mileage | Current odometer reading, from 0 to 600,000 miles. If omitted, available recorded or estimated mileage is used. If none is available, some insights may be unavailable. A supplied zero is treated as 1 mile for calculations. | No | 85000 |
| ZIP code | A five-digit ZIP code for location context. If omitted, nationwide defaults apply. | No | "02134" |
| Trim | A trim hint to narrow the vehicle match. If omitted, the API uses the VIN and available vehicle data. | No | "LX" |
| New vehicle? | Whether to calculate depreciation from new. Defaults to false (used). When true, projections start at vehicle age zero. |
No | false |
| Vehicle price | A positive whole-dollar USD purchase or list price, used only for depreciation. It does not change market value. | No | 12000 |
What will I receive?
A result for each VIN, with vehicle details and a status for each selected insight. The values below illustrate the format; they are not live estimates.
| Data field or group | What it means | Example |
|---|---|---|
| Vehicle details | Identified year, make, model, trim, and other available details. More than one configuration may be returned if it changes an insight. | 2014 Honda Civic LX |
| Market value | Estimated current value, in US dollars. | $13,110 USD |
| Valuation context | Effective mileage when known; ZIP appears only when supplied. | 85,000 miles |
| Depreciation | Projected value lost over each available period. Rates are fractions in the API; 0.05 means about 5.00%. Dollar losses require a starting value. | 3 years: $600 (5.00%)Using a supplied $12,000 price. |
| Remaining lifespan | Estimated remaining years and/or miles. Either measure can be absent. | 7.7 years |
| Availability status | Whether each requested product returned data. | success or not_available |
One VIN, a clearer picture
For example, an inventory team wants market value, depreciation, and remaining lifespan estimates for a vehicle it is reviewing.
You provide
- VIN
"19XFB2F59EE013816"- Current mileage
85000- Vehicle price
12000- Requested products
"market_value"
"depreciation"
"remaining_lifespan"
You receive
- Vehicle
- 2014 Honda Civic LX
- Estimated market value
- $13,110
- Projected depreciation
- 3 years$600 (5.00%)5 years$1,870 (15.59%)
- Estimated remaining lifespan
- 7.7 years95,122 miles
Example values captured on October 15, 2026; not a live valuation. Actual values and availability vary by vehicle and request.
Ready for your technical team
Share the full specification for request formats, response fields, authentication, and errors.
LLM clients
For a single VIN market-value lookup, GET accepts vin and optional mileage and zip query parameters. Use POST for batches and other products. Follow the current capabilities response for access requirements and limits.
GET /api/data/v1/vin-insights?vin=SAJWA6ATXH8K41808&mileage=42343&zip=02116Before requesting VIN insights, call GET /api/data/v1/capabilities to discover the operations, authentication requirements and usage limits available to your request. An API key is not required for eligible requests. First call GET /api/data/v1/capabilities without Authorization. If the returned operation specifies bearer_required: false, submit that operation without an Authorization header. Otherwise, a valid Bearer API key is required. Access remains subject to availability and usage limits.
Get VIN Insights API access
Tell us about your business and expected VIN volume. We will follow up with API access details, coverage information, and pricing.