---
title: "Market Values API"
method: GET
path: "/v2/marketvalue"
tags: ["Market Data"]
---

# Market Values API

`GET /v2/marketvalue`

## Request

- Base URL: `https://marketvalue.vinaudit.com`
- URL: `https://marketvalue.vinaudit.com/v2/marketvalue`
- Auth: API key in query parameter `key`
- TypeScript: <https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/docs/v2/marketvalue/get.ts> (a function with typed inputs; its response is checked against the schema)

Estimates retail, wholesale, and trade-in values for passenger vehicles in the US and Canada using comparable sales records. Submit either `vin` or `id`. Also accepts POST with the same parameters.

## Query parameters

- `vin` string
- `id` string
- `format` 'json' | 'xml' | 'html'
- `mileage` string
- `period` integer
- `type` 'retail' | 'tradein'
- `condition` 'average' | 'like_new' | 'not_great'
- `known_damage` 'frame_damage' | 'airbags_deployed' | 'salvage' | 'brand' | 'rollback' | 'minor_damage' | 'lemon' | 'rental' | 'prior_theft'
- `country` 'usa' | 'canada'

## Response `200`

Market value estimate

- MarketValue
  - `success` boolean
  - `vin` string, nullable
  - `id` string
  - `vehicle` string
  - `mileage` number
  - `count` integer: Data points used for the estimate
  - `mean` number
  - `stdev` number
  - `certainty` integer
  - `period` string[]
  - `prices` object
    - `average` number
    - `below` number
    - `above` number
    - `distribution` object[]
      - `group` object
        - `min` number
        - `max` number
        - `count` integer
  - `adjustments` object
    - `mileage` object
    - `history` object
    - `condition` object
    - `known_damage` object
  - `type` 'retail' | 'wholesale' | 'tradein'

---

[API](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis.md) - [All operations](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/revisions/1f1500e74b46?raw)