Four components per value

Vehicle Market Value API

Price a vehicle from its VIN, mileage and state.

  • Wholesale and retail values per condition
  • Excellent, clean, average and rough tiers
  • Base, mileage, options and regional parts
  • Identity: year, make, model, series, style
Vehicle Market Value API

Our benefits

A number your system can defend.

The value shows its work

Each bucket returns a base value plus what mileage, options and region moved it, so you can show a customer why the number is the number.

Integrate in minutes

Only the VIN is required. Copy the request from the panel below, add mileage and state when you have them, and the first valuation runs in minutes.

People who know valuations

A free sandbox, a documented response, and support that can tell you how a market behaves before you wire the number into an offer screen.

Prices one car, not a model

Mileage, state and condition go in with the VIN, so the estimate is for that specific vehicle in that market rather than a national average.

For developers

Every value, broken into four parts.

The panel on the right is a real request for VIN WBAFR7C57CC811956 at 50,000 miles in California, and the response it returns. Scroll it to see how each value breaks apart, then copy the request and swap in a VIN and mileage of your own.

Each value breaks down
A bucket returns its base value plus separate mileage, add_deduct and regional adjustments.
Every field is optional
A missing bucket means the provider returned no valuation for this VIN or market, not that it is zero.
Call /v2/marketvalue
That is the current route and the shape these fields come from. An older v1 route returns different buckets.
Request
curl -G https://api.carsxe.com/v2/marketvalue \
  -d key=YOUR_API_KEY \
  -d vin=WBAFR7C57CC811956 \
  -d mileage=50000 \
  -d state=CA \
  -d condition=clean
Response
{
  "uid": "FDE60872",
  "input": { "vin": "WBAFR7C57CC811956", "country": "US" },
  "publish_date": "4/8/2025",
  "model_year": "2012",
  "make": "BMW",
  "model": "5-Series",
  "series": "535i",
  "style": "4D Sedan",
  "class_name": "Luxury Car",
  "whole_clean": {
    "base_whole_clean": 5300,
    "mileage_whole_clean": 0,
    "add_deduct_whole_clean": 0,
    "regional_whole_clean": 0
  },
  "retail_clean": {
    "base_retail_clean": 9325,
    "mileage_retail_clean": 0,
    "add_deduct_retail_clean": 0,
    "regional_retail_clean": 0
  }
}

For AI agents

Built into the AI tools you already use

Point your coding agent at the CarsXE MCP server and it can call the API on its own, no client library, no glue code. The same tools are available to chat agents over plain HTTP.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Grok Bot
  • Codex
  • Gemini
  • Hermes Agent
  • OpenClaw
  • opencode
  • & more
Explore integrations

One command. Register the CarsXE MCP server with your editor.

Claude Code
claude mcp add --transport http carsxe https://mcp.carsxe.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"
View the docs

Then just ask. The agent picks the right CarsXE tool and returns structured vehicle data.

Prompt
What is VIN WBAFR7C57CC811956 worth at 50,000 miles

Agent onboarding. Are you an AI agent? Fetch this skill to get an API key and start pulling vehicle data.

SKILL.md
curl -s https://carsxe.com/agent-onboarding/SKILL.md
View the skill

Fair billing

No data, no charge

A lookup we cannot resolve comes back as a 404 and costs you nothing. You are billed only when the API returns data.

Data found200 OK
Data found
{ "uid": "FDE60872", "make": "BMW", "model": "5-Series", "whole_clean": { "base_whole_clean": 5300 }, "retail_clean": { "base_retail_clean": 9325 } }

Billed. One lookup.

No match404 Not Found
No match
{
  "success": false,
  "message": "No data found for this VIN"
}

No charge.

Priced per answer, not per request.

Strongest in the US market

Robust international support

Valuations are strongest in the United States. The endpoint takes a country parameter, and coverage outside that market is thinner.

United States

US

Customer stories

Companies love building with CarsXE

How teams build on CarsXE vehicle data.

“

CarsXE offers MotorTango's customers accurate and reliable vehicle data across many makes and models. Their VIN decoder and specs API are second to none.

Andy Liakos

CTO, MotorTango

“

The API is super easy to work with...it's a damn good API. And trust me, I deal with a lot of third parties and you're the creme de la creme. It's great. Documentation is sound, the result sets are sound. I have nothing to say but, man, it's too easy to work with.

Alan Deitch

Senior Engineering Leader, SpotHero

“

When a customer calls a dealership, we know they have an open recall instantly. That changes what the call is worth. Our agents book the recall alongside whatever the customer originally called about, and the dealer captures service work that used to walk out the door unnoticed. CarsXE's recall data is what makes that possible on every call, at every rooftop we run.

Samee Khan

Founder & CEO, PAM

“

With their VIN decoder and images, we can accurately document what's needed to perform repairs and ADAS calibrations, and we do it much more efficiently — saving dozens of minutes on every single repair. The result is consistent, reliable service at scale for all of our customers, backed by data we trust. CarsXE has become a critical part of our workflow and our ability to grow.

Philip Brossy

Founder & CEO, ADAS Safe

FAQ

Frequently asked questions

Can't find the answer you're looking for? Reach out to our customer support team.

Wholesale and retail values by condition tier, each split into a base value plus mileage, option and regional adjustments, alongside the identity used: year, make, model, series and style.

Get started

Ready for the test drive? Start building today.

Test drive CarsXE's platform. Sign up with your work email.

Vehicle Market Value API