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

# Vehicle Market Value (v1)

`GET /marketvalue`

Get the market value of a vehicle by VIN, including retail, trade-in and auction values.

## Query parameters

- `vin` string, required
- `format` 'json' | 'xml'

## Response `200`

Market value retrieved.

- object
  - `success` boolean
  - `vin` string
  - `retail` string — Retail price of the vehicle.
  - `tradeIn` string — The trade in price of the vehicle.
  - `roughTradeIn` string
  - `averageTradeIn` string
  - `loanValue` string
  - `msrp` string
  - `tradeInValues` object[]
    - `date` string
    - `value` string
  - `auctionValues` object

## Other responses

- `400` — Missing VIN.
- `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.

---

[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/revisions/d90c24450642/schema)