Sample Response
V2
Documentation
Introduction
Enhanced VIN decoder for providing core specification data, standard features, fitted options, msrp and dealer invoice pricing.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/oneauto/vindecodeplus/us?vehicle_identification_number=ABCDE123456F78910
Example Sandbox Request
https://bjbiy52iua.execute-api.eu-west-2.amazonaws.com/dev/oneauto/vindecodeplus/us?vehicle_identification_number=ABCDE123456F78910&sandbox=1
Request Parameters
vehicle_identification_number
mandatory, string, e.g. ABCDE123456F78910
Vehicle identification number (VIN).
Sample Response
{
"success": true,
"result": {
"vehicle_data": {
"vehicle_identification_number": "ABCDE123456F78910",
"model_year": 2017,
"manufacturer_desc": "Porsche",
"model_range_desc": "Macan",
"trim_desc": "GTS",
"version_desc": "GTS",
"body_type_desc": "SUV",
"vehicle_type": "Truck",
"transmission_desc": "Automatic",
"drivetrain_desc": "4WD",
"powertrain_desc": "Combustion",
"engine_desc": "3.0L V6",
"number_cylinders": 6,
"fuel_type_desc": "Premium Unleaded",
"highway_mpg": 23,
"city_mpg": 17,
"number_doors": 5,
"number_seats": 5,
"vehicle_length_in": 186.1,
"vehicle_height_in": 64,
"vehicle_width_in": 76.2,
"vehicleweight_lb": 5688,
"interior_color": "Brown",
"exterior_color": "Black"
},
"pricing_data": {
"wholesale_price_usd": null,
"dealer_invoice_price_usd": 60480,
"msrp_usd": 67200,
"installed_options_msrp_usd": 990,
"delivery_charges_usd": 1050,
"combined_msrp_usd": 69240
},
"current_listing": {
"is_currently_listed": true,
"days_on_market": 49,
"dealer_details": {
"dealer_name": "Porsche Masters",
"dealer_address": "10890 181st Street, Cerritos, CA 90724",
"phone_number": "562-612-0900",
"email": "help@porschemasters.com"
}
},
"warranty_data": [
{
"warranty_type": "total",
"warranty_months": 48,
"warranty_miles": 50000
}
],
"standard_features": [
{
"feature_category": "Interior",
"feature_generic_desc": "Instrument Cluster",
"feature_desc": "Analog Porsche Instrument Cluster"
}
],
"installed_options": [
{
"factory_code": "9VL",
"feature_desc": "BOSE Surround Sound System",
"msrp_usd": "990",
"sale_price_usd": "0",
"is_verified": true,
"confidence_level": "High",
"pack_contents": null
}
]
}
}Response Parameters
success
e.g. true
Whether the api call was successful
vehicle_identification_number
e.g. ABCDE123456F78910
Vehicle identification number (VIN).
model_year
e.g. 2017
Model Year
manufacturer_desc
e.g. Porsche
Manufacturer description
model_range_desc
e.g. Macan
Model range description.
trim_desc
e.g. GTS
Trim description
version_desc
e.g. GTS
Version description
body_type_desc
e.g. SUV
The body type description
vehicle_type
e.g. Truck
Class of vehicle.
transmission_desc
e.g. Automatic
The vehicle's transmission type
drivetrain_desc
e.g. 4WD
Drivetrain
powertrain_desc
e.g. Combustion
Powertrain description
engine_desc
e.g. 3.0L V6
Engine description
number_cylinders
e.g. 6
Number of cylinders within the engine.
fuel_type_desc
e.g. Premium Unleaded
The vehicle's fuel type description
highway_mpg
e.g. 23
Highway miles per gallon fuel consumption
city_mpg
e.g. 17
City miles per gallon fuel consumption
number_doors
e.g. 5
Number of doors.
number_seats
e.g. 5
Number of seats.
vehicle_length_in
e.g. 186.1
Vehicle length in inches
vehicle_height_in
e.g. 64
Vehicle height in inches
vehicle_width_in
e.g. 76.2
Vehicle width in inches
vehicleweight_lb
e.g. 5688
Vehicle weight in pounds
interior_color
e.g. Brown
Interior color of the vehicle
exterior_color
e.g. Black
Exterior color of the vehicle
wholesale_price_usd
True dealer cost after rebates and rollbacks are accounted for
dealer_invoice_price_usd
e.g. 60480
Price a dealer pays before rebates and rollbacks
msrp_usd
e.g. 67200
Manufacturer suggested retail price
installed_options_msrp_usd
e.g. 990
Manufacturer suggested retail price of installed options
delivery_charges_usd
e.g. 1050
Delivery charges when the vehicle was supplied new
combined_msrp_usd
e.g. 69240
Combined MSRP including the vehicle, installed options and delivery
is_currently_listed
e.g. true
Identifies whether the vehicle is currently listed
days_on_market
e.g. 49
The number of days for the current listing
dealer_name
e.g. Porsche Masters
Dealer Name
dealer_address
e.g. 10890 181st Street, Cerritos, CA 90724
Address of the dealer
phone_number
e.g. 562-612-0900
Telephone number
email
e.g. help@porschemasters.com
Email address for the dealer
warranty_type
e.g. total
Type of warranty (e.g. anti corrosion)
warranty_months
e.g. 48
Warranty months.
warranty_miles
e.g. 50000
Maximum miles covered under warranty
feature_category
e.g. Interior
The feature category
feature_generic_desc
e.g. Instrument Cluster
The feature generic description
feature_desc
e.g. Analog Porsche Instrument Cluster
The feature description
factory_code
e.g. 9VL
The factory code
feature_desc
e.g. BOSE Surround Sound System
The feature description
msrp_usd
e.g. 990
Manufacturer suggested retail price
sale_price_usd
e.g. 0
The price the option was listed at
is_verified
e.g. true
Indicates whether the option has been verified through windscreen data
confidence_level
e.g. High
Confidence level of match to OE option
pack_contents
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