---
title: "Vehicle Market Value (v2)"
method: GET
path: "/v2/marketvalue"
tags: ["Market Value"]
---

# Vehicle Market Value (v2)

`GET /v2/marketvalue`

Get detailed market values for a VIN, including wholesale, retail and trade-in values across condition tiers, with optional adjustments for US state, mileage and condition.

## Query parameters

- `vin` string, required
- `state` string
- `mileage` number
- `condition` 'excellent' | 'clean' | 'average' | 'rough'

## Response `200`

Market value retrieved.

- object
  - `uid` string
  - `input` object
  - `publish_date` string
  - `state` string
  - `country` string
  - `model_year` string
  - `make` string
  - `model` string
  - `series` string
  - `style` string
  - `class_name` string
  - `whole_xclean` object
  - `whole_clean` object
  - `whole_avg` object
  - `whole_rough` object
  - `retail_xclean` object
  - `retail_clean` object
  - `retail_avg` object
  - `retail_rough` object

## Other responses

- `400` — Missing/invalid VIN, mileage or condition.
- `401` — Missing API key, unknown/disabled API key, or inactive account.
- `404` — No data found for this VIN.
- `429` — API usage limit exceeded for the current billing period.
- `500` — Internal server error.
- `503` — Upstream market value provider is unavailable.

---

[API](https://skmtc.net/carsxe/apis/carsxe-api.md) · [All operations](https://skmtc.net/carsxe/apis/carsxe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carsxe/carsxe-api/versions/0343df02d7c4/schema)