UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Retail Market Value (US)

Powered by VIN Audit

Understand What a Vehicle Is Worth in Today's US Retail Market

Access data-driven US retail vehicle valuations based on sales listings, providing a transparent view of market pricing and the underlying data behind each valuation.

The Retail Market Value API provides low, average and high retail values alongside pricing distributions, valuation adjustments and supporting sales listings—helping automotive businesses price, value and assess vehicles with greater confidence.

Key Features

Vehicle Identification

Identifies key vehicle attributes including make, model, trim, year and fuel type, providing the foundation for an accurate market valuation.

Retail Market Value

Access low, average and high retail market values calculated from an identified number of comparable sales listings, together with a confidence level indicating the strength of the valuation.

Sale Price Distribution

Understand how comparable vehicle listings are distributed across up to 10 price bands, providing greater context than a single valuation and a clearer picture of the wider retail market.

Valuation Adjustments

See clearly identified adjustments for mileage, condition, vehicle history and previous damage, providing greater insight into how individual vehicle valuations have been arrived at.

Sales Listings

See the data behind the valuation. Underlying sales listings provide full transparency and market evidence to support the valuation.

Updated Daily

Keep pace with a changing market - sales listings are updated daily, ensuring valuations respond to changes in supply, advertised pricing and wider market conditions.

Pricing

PAYG
72p
Per Use
Business
48p
Per Use
Enterprise
24p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)72p82c90c
Business (Per Use)48p55c60c
Enterprise (Per Use)24p27c30c

Documentation

Introduction

Retail market valuation, based on market inventory.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/vinaudit/retailmarketvalue/us?vehicle_identification_number=ABCDE123456F78910&current_mileage=12345&sales_history_days=90&vehicle_condition=like_new&previous_damage=airbags_deployed

Example Sandbox Request

https://sandbox.oneautoapi.com/vinaudit/retailmarketvalue/us?vehicle_identification_number=ABCDE123456F78910&current_mileage=12345&sales_history_days=90&vehicle_condition=like_new&previous_damage=airbags_deployed

Request Parameters

vehicle_identification_number
mandatory, string, e.g. ABCDE123456F78910
Vehicle identification number (VIN).
current_mileage
mandatory, string, e.g. 12345
Current mileage of the vehicle
sales_history_days
optional, string, e.g. 90
The number of days sales history used to calculate the valuation.
vehicle_condition
optional, string, e.g. like_new
Possible values are: average, like_new, not_great
previous_damage
optional, string, e.g. airbags_deployed
Possible values are: 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)

Sample Response

{
  "success": true,
  "result": {
    "vehicle_data": {
      "vehicle_identification_number": "2C3CDXAT3PH666666",
      "vehicle_desc": "2023 Dodge Charger R/T",
      "manufacturer_desc": "Dodge",
      "model_range_desc": "Charger",
      "trim_desc": "R/T",
      "model_year": 2023,
      "fuel_type_desc": "Gas"
    },
    "pricing_data": {
      "mean_valuation_usd": 31563.75,
      "standard_deviation_usd": 4218,
      "sale_prices_count": 867,
      "confidence_level": 99,
      "sale_date_from": "2026-06-25",
      "sale_date_to": "2026-09-07",
      "retail_high_valuation_usd": 35432.83,
      "retail_average_valuation_usd": 31563.75,
      "retail_low_valuation_usd": 27694.67
    },
    "distribution_data": [
      {
        "sale_prices_count": 87,
        "sale_price_max": 28575,
        "sale_price_min": 19989
      }
    ],
    "adjustments_data": {
      "mileage_adjustment": -2129,
      "history_adjustment": 0,
      "condition_adjustment": 3369,
      "damage_adjustment": -6221
    },
    "sales_data": [
      {
        "sale_date": "2026-09-06",
        "vehicle_identification_number": "2C3CDXAT3PH777777",
        "engine_desc": "5.7",
        "fuel_type_desc": "Gas",
        "mileage_observed": 44700,
        "advertised_price_usd": 23800,
        "mileage_adjusted_price_usd": 23096.16,
        "zip_code": "30083",
        "state_code": "GA",
        "latitude": "33.8072092",
        "longitude": "-84.1878152"
      }
    ]
  }
}

Response Parameters

success
e.g. true
Whether the api call was successful
vehicle_identification_number
e.g. 2C3CDXAT3PH666666
Vehicle identification number (VIN).
vehicle_desc
e.g. 2023 Dodge Charger R/T
The Vehicle description
manufacturer_desc
e.g. Dodge
Manufacturer description
model_range_desc
e.g. Charger
Model range description.
trim_desc
e.g. R/T
Trim description
model_year
e.g. 2023
Model Year
fuel_type_desc
e.g. Gas
The vehicle's fuel type description
mean_valuation_usd
e.g. 31563.75
The average (mean) valuation in US Dollars.
standard_deviation_usd
e.g. 4218
The standard deviation in US Dollars.
sale_prices_count
e.g. 867
The number of sale prices used to calculate the valuation.
confidence_level
e.g. 99
Confidence level (0-100)
sale_date_from
e.g. 2026-06-25
The earliest date of the sale prices used to calculate the valuation.
sale_date_to
e.g. 2026-09-07
The latest date of the sale prices used to calculate the valuation.
retail_high_valuation_usd
e.g. 35432.83
The high retail valuation in US Dollars.
retail_average_valuation_usd
e.g. 31563.75
The average retail valuation in US Dollars.
retail_low_valuation_usd
e.g. 27694.67
The low retail valuation in US Dollars.
sale_prices_count
e.g. 87
The number of sale prices used to calculate the valuation.
sale_price_max
e.g. 28575
The maximum sale price in this segment of sale prices.
sale_price_min
e.g. 19989
The minimum sale price in this segment of sale prices.
mileage_adjustment
e.g. -2129
Adjustment made for mileage.
history_adjustment
e.g. 0
Adjustment made for vehicle history.
condition_adjustment
e.g. 3369
Adjustment made for vehicle condition.
damage_adjustment
e.g. -6221
Adjustment made for damage.
sale_date
e.g. 2026-09-06
Date of sale.
vehicle_identification_number
e.g. 2C3CDXAT3PH777777
Vehicle identification number (VIN).
engine_desc
e.g. 5.7
Engine description
fuel_type_desc
e.g. Gas
The vehicle's fuel type description
mileage_observed
e.g. 44700
Vehicle odometer reading
advertised_price_usd
e.g. 23800
Advertised price of the vehicle.
mileage_adjusted_price_usd
e.g. 23096.16
The advertised price, adjusted for mileage.
zip_code
e.g. 30083
ZIP Code for the centre of the search for comparables.
state_code
e.g. GA
The state code.
latitude
e.g. 33.8072092
Latitude
longitude
e.g. -84.1878152
Longitude

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From VIN Audit

Retail Market Value (Canada)

Access low, average and high retail pricing for Canada via API, with supporting sales listings - helping you appraise trade-ins and price stock.

Retail Market Value (US)

Access low, average and high retail pricing via API, with supporting sales listings - helping you price, value and assess vehicles with confidence.

Vehicle History Report (US)

Access US Vehicle History Report data via a single API. NMVTIS, salvage history, liens, accidents and previous sales data.

Vehicle History Report Lite (US)

Access a cost-effective first layer of vehicle intelligence via API, combining vehicle specs with theft, accident, salvage, pricing and previous sales

Wholesale Valuation (Canada)

Access Canadian wholesale vehicle valuations via API. Based on dealer auction data, it gives an accurate view of what vehicles are worth in the trade