docs / api / market / values

Market Values API

The Market Values API estimates retail, wholesale, and trade-in values for passenger vehicles in the United States and Canada using millions of comparable sales records. It supports pricing tools, inventory analysis, and market comparisons. Use this endpoint for both GET and POST requests. Submit either `vin` or `id` with your API key and optional valuation parameters. It helps teams benchmark vehicle pricing against current market data.

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

Request Parameters

Parameter

key

required

Example

YOUR_API_KEY_HERE

Description

Your VinAudit API key

Parameter

vin

optional

Example

2T1BURHE3EC020936

Description

The vehicle identification number.

Required when querying market values by VIN.

Parameter

id

optional

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 VIN Decoder API. This value should be selected from the API response, not manually constructed.

Required when querying market values by ID.

Parameter

format

optional

Example

json

Description

The output format:

  • json (default)

  • xml

  • html

Parameter

mileage

optional

Example

90000

Description

The mileage used for valuation. Accepts a numeric mileage value or average. If omitted, the API uses average mileage by default.

Parameter

period

optional

Example

90

Description

Number of days to look back for sales data (max: 365)

Parameter

type

optional

Example

retail

Description

Market type for valuation.

Options:

  • retail (default) – Consumer market pricing

  • wholesale – Dealer auction pricing

  • tradein – Trade-in value pricing

Parameter

condition

optional

Example

average

Description

Vehicle condition adjustment.

Options:

  • average (default)

  • like_new

  • not_great

Parameter

known_damage

optional

Example

frame_damage

Description

Known vehicle damage that affects pricing.

Options:

  • frame_damage – Major structural damage

  • airbags_deployed – Airbag deployment history

  • salvage – Salvage title history

  • brand – Branded title

  • rollback – Odometer rollback

  • minor_damage – Minor accident damage

  • lemon – Lemon law vehicle

  • rental – Former rental vehicle

  • prior_theft – Vehicle has prior theft history

Parameter

country

optional

Example

usa

Description

Country for market valuation

Options:

  • usa (default)

  • canada

Response Attributes

Field

success

Example

true

Description

Whether market value data has been retrieved

Field

vin

Example

2T1BURHE3EC020936

Description

The vehicle identification number

Field

id

Example

2014_toyota_corolla_s

Description

The unique vehicle YMMT ID

Field

vehicle

Example

2014 Toyota Corolla S

Description

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

Field

mileage

Example

75248

Description

The mileage used to compute the market value

Field

count

Example

120

Description

The number of data points used for estimate

Field

mean

Example

7044

Description

The estimate average market price

Field

stdev

Example

1276

Description

Standard deviation of prices

Field

certainty

Example

99

Description

The statistical confidence in the market value

Field

period

Example

["2015-06-27", "2015-07-16"]

Description

The date range of the historical sales data used

Field

prices

Example

{"average": 7044, "below": 5768, "above": 8320}

Description

The estimated average market, below market, and above market prices

Field

prices.distribution

Example

{"min": 2495, "max": 2995, "count": 10}

Description

Price distribution buckets showing ranges and counts of data points

Field

adjustments

Example

See nested fields below

Description

Breakdown of adjustments applied to the market value based on mileage, history, condition, and known damage

Field

adjustments.mileage

Example

{"average": 167391.71, "input": 167391.71, "adjustment": 0}

Description

Adjustment applied based on vehicle mileage

Field

adjustments.history

Example

{"records": [], "adjustment": 0}

Description

Adjustment applied based on vehicle history records

Field

adjustments.condition

Example

{"input": "not_great", "adjustment": -1472}

Description

Adjustment applied for vehicle condition (e.g., like_new, not_great)

Field

adjustments.known_damage

Example

{"input": "frame_damage", "adjustment": -2325}

Description

Adjustment applied for known vehicle damage (e.g., minor_damage, frame_damage, lemon)

Field

type

Example

wholesale

Description

Market type for valuation (retail, wholesale, or tradein)

Example Requests and Responses (VIN & ID Lookup)

Using vehicle or Year/Make/Model/Trim identifiers

Search by VIN — Request

HTTP

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

Search by VIN — 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"
}

Search by ID — Request

https://marketvalue.vinaudit.com/v2/marketvalue
?key=YOUR_API_KEY_HERE
&format=json
&period=90
&id=2005_toyota_corolla_ce

Search by ID — Response

json
{
  "vin": null,
  "success": true,
  "id": "2005_toyota_corolla_ce",
  "vehicle": "2005 Toyota Corolla CE",
  "mean": 4728.67,
  "stdev": 1290,
  "count": 97,
  "mileage": 167103,
  "certainty": 99,
  "period": [
    "2025-08-17",
    "2025-09-24"
  ],
  "prices": {
    "average": 4728.67,
    "below": 3438.1,
    "above": 6019.24,
    "distribution": [
      {
        "group": {
          "min": 2495,
          "max": 2995,
          "count": 10
        }
      },
      {
        "group": {
          "min": 2995,
          "max": 3500,
          "count": 10
        }
      },
      {
        "group": {
          "min": 3500,
          "max": 3995,
          "count": 10
        }
      },
      {
        "group": {
          "min": 3995,
          "max": 4495,
          "count": 9
        }
      },
      {
        "group": {
          "min": 4495,
          "max": 4800,
          "count": 10
        }
      },
      {
        "group": {
          "min": 4800,
          "max": 4995,
          "count": 10
        }
      },
      {
        "group": {
          "min": 4995,
          "max": 5000,
          "count": 9
        }
      },
      {
        "group": {
          "min": 5000,
          "max": 5991,
          "count": 10
        }
      },
      {
        "group": {
          "min": 5991,
          "max": 6900,
          "count": 10
        }
      },
      {
        "group": {
          "min": 6900,
          "max": 7000,
          "count": 9
        }
      }
    ]
  },
  "adjustments": {
    "mileage": {
      "average": 167103.09,
      "input": 167103.09,
      "adjustment": 0
    },
    "history": {
      "records": [],
      "adjustment": 0
    },
    "condition": {
      "input": null,
      "adjustment": 0
    },
    "known_damage": {
      "input": null,
      "adjustment": 0
    }
  },
  "type": "retail"
}

Example Requests and Responses (Market Type)

Using the type parameter for retail, wholesale, and trade-in values

Market Type: Retail — Request

https://marketvalue.vinaudit.com/v2/marketvalue
?key=YOUR_API_KEY_HERE
&format=json
&vin=2T1BURHE3EC020936
&type=retail

Market Type: Retail — Response

json
{
  "vin": "2T1BURHE3EC020936",
  "success": true,
  "id": "2014_toyota_corolla_s",
  "vehicle": "2014 Toyota Corolla S",
  "mean": 10882.53,
  "stdev": 2396,
  "count": 255,
  "mileage": 129598,
  "certainty": 99,
  "period": [
    "2025-08-17",
    "2025-10-06"
  ],
  "prices": {
    "above": 13279.11,
    "average": 10882.53,
    "below": 8485.95,
    "distribution": [
      {
        "group": {
          "count": 26,
          "max": 7993,
          "min": 5580
        }
      },
      {
        "group": {
          "count": 26,
          "max": 8900,
          "min": 7993
        }
      },
      {
        "group": {
          "count": 25,
          "max": 9495,
          "min": 8900
        }
      },
      {
        "group": {
          "count": 26,
          "max": 9995,
          "min": 9495
        }
      },
      {
        "group": {
          "count": 25,
          "max": 10990,
          "min": 9995
        }
      },
      {
        "group": {
          "count": 26,
          "max": 11500,
          "min": 10990
        }
      },
      {
        "group": {
          "count": 25,
          "max": 12468,
          "min": 11500
        }
      },
      {
        "group": {
          "count": 26,
          "max": 12995,
          "min": 12468
        }
      },
      {
        "group": {
          "count": 25,
          "max": 13995,
          "min": 12995
        }
      },
      {
        "group": {
          "count": 25,
          "max": 16031,
          "min": 13995
        }
      }
    ]
  },
  "adjustments": {
    "mileage": {
      "adjustment": 0,
      "average": 129598.16,
      "input": 129598.16
    },
    "history": {
      "records": [],
      "adjustment": 0
    },
    "condition": {
      "input": null,
      "adjustment": 0
    },
    "known_damage": {
      "input": null,
      "adjustment": 0
    }
  },
  "type": "retail"
}

Market Type: Wholesale — Request

https://marketvalue.vinaudit.com/v2/marketvalue
?key=YOUR_API_KEY_HERE
&format=json
&vin=2T1BURHE3EC020936
&type=wholesale

Market Type: Wholesale — Response

json
{
  "vin": "2T1BURHE3EC020936",
  "success": true,
  "id": "2014_toyota_corolla_s",
  "vehicle": "2014 Toyota Corolla S",
  "mean": 5802.13,
  "stdev": 2396,
  "count": 255,
  "mileage": 129598,
  "certainty": 99,
  "period": [
    "2025-08-17",
    "2025-10-06"
  ],
  "prices": {
    "above": 13279.11,
    "average": 10882.53,
    "below": 8485.95,
    "distribution": [
      {
        "group": {
          "count": 26,
          "max": 7993,
          "min": 5580
        }
      },
      {
        "group": {
          "count": 26,
          "max": 8900,
          "min": 7993
        }
      },
      {
        "group": {
          "count": 25,
          "max": 9495,
          "min": 8900
        }
      },
      {
        "group": {
          "count": 26,
          "max": 9995,
          "min": 9495
        }
      },
      {
        "group": {
          "count": 25,
          "max": 10990,
          "min": 9995
        }
      },
      {
        "group": {
          "count": 26,
          "max": 11500,
          "min": 10990
        }
      },
      {
        "group": {
          "count": 25,
          "max": 12468,
          "min": 11500
        }
      },
      {
        "group": {
          "count": 26,
          "max": 12995,
          "min": 12468
        }
      },
      {
        "group": {
          "count": 25,
          "max": 13995,
          "min": 12995
        }
      },
      {
        "group": {
          "count": 25,
          "max": 16031,
          "min": 13995
        }
      }
    ]
  },
  "adjustments": {
    "mileage": {
      "adjustment": 0,
      "average": 129598.16,
      "input": 129598.16
    },
    "history": {
      "records": [],
      "adjustment": 0
    },
    "condition": {
      "input": null,
      "adjustment": 0
    },
    "known_damage": {
      "input": null,
      "adjustment": 0
    }
  },
  "type": "wholesale"
}

Market Type: Trade-In — Request

https://marketvalue.vinaudit.com/v2/marketvalue
?key=YOUR_API_KEY_HERE
&format=json
&vin=2T1BURHE3EC020936
&type=tradein

Market Type: Trade-In — Response

json
{
  "vin": "2T1BURHE3EC020936",
  "success": true,
  "id": "2014_toyota_corolla_s",
  "vehicle": "2014 Toyota Corolla S",
  "mean": 5715.1,
  "stdev": 2396,
  "count": 255,
  "mileage": 129598,
  "certainty": 99,
  "period": [
    "2025-08-17",
    "2025-10-06"
  ],
  "prices": {
    "above": 13279.11,
    "average": 10882.53,
    "below": 8485.95,
    "distribution": [
      {
        "group": {
          "count": 26,
          "max": 7993,
          "min": 5580
        }
      },
      {
        "group": {
          "count": 26,
          "max": 8900,
          "min": 7993
        }
      },
      {
        "group": {
          "count": 25,
          "max": 9495,
          "min": 8900
        }
      },
      {
        "group": {
          "count": 26,
          "max": 9995,
          "min": 9495
        }
      },
      {
        "group": {
          "count": 25,
          "max": 10990,
          "min": 9995
        }
      },
      {
        "group": {
          "count": 26,
          "max": 11500,
          "min": 10990
        }
      },
      {
        "group": {
          "count": 25,
          "max": 12468,
          "min": 11500
        }
      },
      {
        "group": {
          "count": 26,
          "max": 12995,
          "min": 12468
        }
      },
      {
        "group": {
          "count": 25,
          "max": 13995,
          "min": 12995
        }
      },
      {
        "group": {
          "count": 25,
          "max": 16031,
          "min": 13995
        }
      }
    ]
  },
  "adjustments": {
    "mileage": {
      "adjustment": 0,
      "average": 129598.16,
      "input": 129598.16
    },
    "history": {
      "records": [],
      "adjustment": 0
    },
    "condition": {
      "input": null,
      "adjustment": 0
    },
    "known_damage": {
      "input": null,
      "adjustment": 0
    }
  },
  "type": "tradein"
}

Other Request and Response Examples

For condition and known damage inputs, plus no-data response cases

Condition and Known Damage Adjustments — Request

https://marketvalue.vinaudit.com/v2/marketvalue
?key=YOUR_API_KEY_HERE
&format=json
&vin=2T1BURHE3EC020936
&type=wholesale
&known_damage=minor_damage
&condition=not_great

Condition and Known Damage Adjustments — Response

json
{
  "vin": "2T1BURHE3EC020936",
  "success": true,
  "id": "2014_toyota_corolla_s",
  "vehicle": "2014 Toyota Corolla S",
  "mean": 4276.55,
  "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": "not_great",
      "adjustment": -812
    },
    "known_damage": {
      "input": "minor_damage",
      "adjustment": -1176
    }
  },
  "type": "wholesale"
}

No Data Found — Request

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

No Data Found — Response

json
{
  "vehicle": null,
  "success": false,
  "error": "An error occurred. Please try again in a few minutes. If the issue persists, contact prodsupport@vinaudit.com for assistance.",
  "vin": "MVXBR12EXCP901213",
  "data": "no_data"
}

Error Responses

  • invalid_key: The API key is missing, invalid, disabled, or not authorized for the Market Value service.
  • rate_limit_exceeded: The API key is valid, but the account or key has reached its allowed rate or usage limit.
  • no_data: The request was valid, but there is not enough pricing data available to return a reliable market value.
  • invalid_vehicle: The vehicle input could not be matched to a valid vehicle record.
  • invalid_request: The request is missing required information or contains unsupported or invalid parameter values.
  • internal_error: The request could not be completed due to a temporary service issue. Please retry later.

Ready to build?

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

Start Free TrialView API Docs