UK-EN

Market Pricing from VIN (US)

Powered by Carketa

Accurate Local Used Car Market Pricing Data for the US.

Trusted by 1000+ dealers, Carketa aggregates dealer inventory from 60,000+ rooftops to deliver market-matched pricing accuracy for improved stock turn and margin control. 

Simple to integrate - local market pricing based on VIN,  Mileage and ZIP Code. 


Key Features

VIN Lookup

For accurate vehicle identification

Local Market Pricing

Based on comparable listings

Comparables

Current and recent market listings

Pricing

PAYG
60p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)60p68c75c
Business (Per Use)40p45c50c
Enterprise (Per Use)20p23c25c

Sample Response

Documentation

Introduction

Local market pricing based on VIN, ZIP Code and Mileage.

Header

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

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

Example Request

https://api.oneautoapi.com/carketa/marketpricingfromvin/?vehicle_identification_number=ABCDE123456F78910&zip_code=90310&current_mileage=12345&mileage_difference=500&include_recent_comparables=True&include_current_comparables=False

Example Sandbox Request

https://sandbox.oneautoapi.com/carketa/marketpricingfromvin/?vehicle_identification_number=ABCDE123456F78910&zip_code=90310&current_mileage=12345&mileage_difference=500&include_recent_comparables=True&include_current_comparables=False

Request Parameters

vehicle_identification_number
mandatory, string, e.g. ABCDE123456F78910
Vehicle identification number (VIN).
zip_code
mandatory, string, e.g. 90310
ZIP Code for the centre of the search for comparables.
current_mileage
mandatory, string, e.g. 12345
Current mileage of the vehicle
mileage_difference
optional, string, e.g. 500
Maximum difference in mileage when searching for comparable vehicles. If used the search radius will scale to find the required comparables.
include_recent_comparables
optional, string, e.g. True
Controls whether recent listings are included in the comparables
include_current_comparables
optional, string, e.g. False
Controls whether current listings are included in the comparables

Sample Response

{
  "success": true,
  "result": {
    "market_pricing_data": {
      "average_market_price_usd": 24873.7,
      "low_price_usd": 22250,
      "high_price_usd": 27085,
      "low_mileage_usd": 45090,
      "high_mileage_usd": 54898,
      "average_days_on_market": 87.2,
      "current_comparables": [
        {
          "model_year": 2023,
          "manufacturer_desc": "Nissan",
          "model_range_desc": "Rogue",
          "trim_desc": "SL",
          "mileage_observed": 50953,
          "distance_from_zip_code": 236.12927387256892,
          "color": "Black",
          "advertised_price_usd": 25900,
          "latitude": 44.532865,
          "longitude": -109.045306,
          "days_on_market": 321
        }
      ],
      "recent_comparables": [
        {
          "model_year": 2023,
          "manufacturer_desc": "Nissan",
          "model_range_desc": "Rogue",
          "trim_desc": "SL",
          "mileage_observed": 54469,
          "distance_from_zip_code": 416.50779510910064,
          "color": "Red",
          "advertised_price_usd": 23998,
          "latitude": 38.890371,
          "longitude": -104.71664,
          "days_on_market": 63
        }
      ]
    }
  },
  "error": "If there is an error the message would go here"
}

Response Parameters

success
e.g. true
Whether the api call was successful
average_market_price_usd
e.g. 24873.7
The average market price based on the comparables
low_price_usd
e.g. 22250
The lowest price of the comparables
high_price_usd
e.g. 27085
The highest price of the comparables
low_mileage_usd
e.g. 45090
The lowest mileage of the comparables
high_mileage_usd
e.g. 54898
The highest mileage of the comparables
average_days_on_market
e.g. 87.2
The average days on market of the comparables
model_year
e.g. 2023
Model Year
manufacturer_desc
e.g. Nissan
Manufacturer description
model_range_desc
e.g. Rogue
Model range description.
trim_desc
e.g. SL
Trim description
mileage_observed
e.g. 50953
Vehicle odometer reading
distance_from_zip_code
e.g. 236.12927387256892
Distance from the ZIP Code provided
color
e.g. Black
The vehicle color
advertised_price_usd
e.g. 25900
Advertised price of the vehicle.
latitude
e.g. 44.532865
Latitude
longitude
e.g. -109.045306
Longitude
days_on_market
e.g. 321
The number of days for the current listing
model_year
e.g. 2023
Model Year
manufacturer_desc
e.g. Nissan
Manufacturer description
model_range_desc
e.g. Rogue
Model range description.
trim_desc
e.g. SL
Trim description
mileage_observed
e.g. 54469
Vehicle odometer reading
distance_from_zip_code
e.g. 416.50779510910064
Distance from the ZIP Code provided
color
e.g. Red
The vehicle color
advertised_price_usd
e.g. 23998
Advertised price of the vehicle.
latitude
e.g. 38.890371
Latitude
longitude
e.g. -104.71664
Longitude
days_on_market
e.g. 63
The number of days for the current listing
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call

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 Carketa