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

Wholesale Valuation (US)

Powered by VIN Audit

Accurate Dealer Auction Values for Smarter Stock Decisions

US wholesale vehicle valuations based on dealer auction data, giving automotive businesses an accurate view of what vehicles are worth within the trade.

The Wholesale Valuation API supports key decisions throughout the vehicle lifecycle—from acquisitions and disposals,  to trade-in values. 

For dealers and automotive platforms, it provides an important distinction between retail market value and achievable wholesale value, helping businesses buy stock at the right price, manage trade-ins effectively and improve their overall margin management. 

Key Features

Vehicle Identification

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

Wholesale Pricing

Wholesale valuations are based on dealer auction data, providing a more accurate indication of achievable trade value.

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.

Pricing

PAYG
£1.00
Per Use
Business
80p
Per Use
Enterprise
60p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)£1.00€1.15$1.25
Business (Per Use)80p90c$1.00
Enterprise (Per Use)60p68c75c

Documentation

Introduction

Wholesale market valuation, based on dealer auction results.

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/wholesalevaluation/us?vehicle_identification_number=3GNAXJEV2JS123456&current_mileage=12345&sales_history_days=30&vehicle_condition=average&previous_damage=rental

Example Sandbox Request

https://sandbox.oneautoapi.com/vinaudit/wholesalevaluation/us?vehicle_identification_number=3GNAXJEV2JS123456&current_mileage=12345&sales_history_days=30&vehicle_condition=average&previous_damage=rental

Request Parameters

vehicle_identification_number
mandatory, string, e.g. 3GNAXJEV2JS123456
Vehicle identification number (VIN).
current_mileage
mandatory, string, e.g. 12345
Current mileage of the vehicle
sales_history_days
optional, string, e.g. 30
The number of days sales history used to calculate the valuation.
vehicle_condition
optional, string, e.g. average
Possible values are: average, like_new, not_great
previous_damage
optional, string, e.g. rental
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": "3GNAXJEV2JS123456",
      "vehicle_desc": "2018 Chevrolet Equinox LT",
      "manufacturer_desc": "Chevrolet",
      "model_range_desc": "Equinox",
      "trim_desc": "LT",
      "model_year": 2018,
      "fuel_type_desc": "Gas"
    },
    "auction_valuation_data": {
      "wholesale_high_valuation_usd": 11070.18,
      "wholesale_average_valuation_usd": 9439.69,
      "wholesale_low_valuation_usd": 7809.21
    },
    "adjustments_data": {
      "mileage_adjustment": 3370,
      "history_adjustment": 0,
      "condition_adjustment": 1432,
      "damage_adjustment": -2235
    }
  }
}

Response Parameters

success
e.g. true
Whether the api call was successful
vehicle_identification_number
e.g. 3GNAXJEV2JS123456
Vehicle identification number (VIN).
vehicle_desc
e.g. 2018 Chevrolet Equinox LT
The Vehicle description
manufacturer_desc
e.g. Chevrolet
Manufacturer description
model_range_desc
e.g. Equinox
Model range description.
trim_desc
e.g. LT
Trim description
model_year
e.g. 2018
Model Year
fuel_type_desc
e.g. Gas
The vehicle's fuel type description
wholesale_high_valuation_usd
e.g. 11070.18
High wholesale valuation, in US dollars.
wholesale_average_valuation_usd
e.g. 9439.69
Average wholesale valuation, in US dollars.
wholesale_low_valuation_usd
e.g. 7809.21
Low wholesale valuation, in US dollars.
mileage_adjustment
e.g. 3370
Adjustment made for mileage.
history_adjustment
e.g. 0
Adjustment made for vehicle history.
condition_adjustment
e.g. 1432
Adjustment made for vehicle condition.
damage_adjustment
e.g. -2235
Adjustment made for damage.

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