docs / api / market / values

Market Values API

The Market Values API estimates the retail, wholesale, and trade-in values for passenger vehicles located in the United States and Canada. This market value by VIN or Year/Make/Model/Trim is based on millions of comparable vehicle sales stored in VinAudit’s sales database. Access to the vehicle market value API requires an API account with Market Value access enabled.

GET

https://marketvalue.vinaudit.com/v2/marketvalue

Request Parameters

Parameter

vin

required

Example

2T1BURHE3EC020936

Description

The vehicle identification number

Parameter

required

Example

2014_toyota_corolla_s

Description

The unique identifier for the year/make/model/trim combination as returned by the selections function of VinAudit’s Specifications API.

(Note: This id should not be constructed text but rather be selected from our Specifications API)

Parameter

key

required

Example

YOUR_API_KEY_HERE

Description

Your VinAudit API key

Parameter

format

optional

Example

json

Description

The output format:

json (default)
xml
html

Parameter

mileage

optional

Example

9000

Description

The current mileage of the vehicle (if not specified, average mileage is used)

Parameter	Description	Example
vinrequired	The vehicle identification number	2T1BURHE3EC020936
idrequired	The unique identifier for the year/make/model/trim combination as returned by the selections function of VinAudit’s Specifications API. (Note: This id should not be constructed text but rather be selected from our Specifications API)	2014_toyota_corolla_s
keyrequired	Your VinAudit API key	YOUR_API_KEY_HERE
formatoptional	The output format: json (default) xml html	json
mileageoptional	The current mileage of the vehicle (if not specified, average mileage is used)	9000

Response attributes

Field

success

Type

true

Description

Whether market value data has been retrieved

Field

vin

Type

2T1BURHE3EC020936

Description

The vehicle identification number

Field

Type

2014_toyota_corolla_s

Description

The unique vehicle YMMT ID

Field

vehicle

Type

2014 Toyota Corolla S

Description

The vehicle title (Year, Make, Model, Trim)

Field	Description	Type
success	`Whether market value data has been retrieved`	true
vin	The vehicle identification number	2T1BURHE3EC020936
id	The unique vehicle YMMT ID	2014_toyota_corolla_s
vehicle	The vehicle title (Year, Make, Model, Trim)	2014 Toyota Corolla S

Example Request

HTTP

https://marketvalue.vinaudit.com/v2/marketvalue?key=YOUR_API_KEY_HERE&format=json&period=90&mileage=average&vin=2T1BURHE3EC020936

Example Response

JSON

{
  "vin": "2T1BURHE3EC020936",
  "success": true,
  "id": "2014_toyota_corolla_s",
  "vehicle": "2014 Toyota Corolla S",
  "mean": 10880.54,
  "stdev": 2400,
  "count": 271,
  "mileage": 130163,
  "certainty": 99,
  "period": [
    "2025-08-17",
    "2025-10-10"
  ],
  "prices": {
    "above": 13281.53,
    "average": 10880.54,
    "below": 8479.55,
    "distribution": [
      {
        "group": {
          "count": 28,
          "max": 7993,
          "min": 5580
        }
      },
      {
        "group": {
          "count": 27,
          "max": 8900,
          "min": 7993
        }
      },
      {
        "group": {
          "count": 27,
          "max": 9495,
          "min": 8900
        }
      },
      {
        "group": {
          "count": 27,
          "max": 9995,
          "min": 9495
        }
      },
      {
        "group": {
          "count": 27,
          "max": 10990,
          "min": 9995
        }
      },
      {
        "group": {
          "count": 27,
          "max": 11500,
          "min": 10990
        }
      },
      {
        "group": {
          "count": 27,
          "max": 12399,
          "min": 11500
        }
      },
      {
        "group": {
          "count": 27,
          "max": 12995,
          "min": 12399
        }
      },
      {
        "group": {
          "count": 27,
          "max": 13995,
          "min": 12995
        }
      },
      {
        "group": {
          "count": 27,
          "max": 16031,
          "min": 13995
        }
      }
    ]
  },
  "adjustments": {
    "mileage": {
      "adjustment": 0,
      "average": 130163.9,
      "input": 130163.9
    },
    "history": {
      "records": [],
      "adjustment": 0
    },
    "condition": {
      "input": null,
      "adjustment": 0
    },
    "known_damage": {
      "input": null,
      "adjustment": 0
    }
  },
  "type": "retail"
}

Ready to build ?

Access the Market Values API with a free developer account. No credit card required.