Decode Vehicle from VIN
decodeVinFull Description
Decode vehicle details from a VIN.
Parameters (1 required, 1 optional)
vinstringThe vehicle identification number (VIN).
useGraphQlbooleanIf true, use the GraphQL VIN decode endpoint (default).
The Edmunds App helps you see what your car is worth right now by connecting you directly to Edmunds’ partners like CarMax and EchoPark. In minutes, you can receive up to three real, redeemable offers for your vehicle from competing buyers—right inside the chat, with no pressure to sell.
If you're wondering “How much is my car worth?” or “Where can I sell my car?”, Edmunds helps you get real answers fast.
How it works
If an instant offer isn’t available for your specific vehicle, we’ll provide an Edmunds True Market Value® (TMV®) estimate so you still have a data-driven price benchmark.
Edmunds has been helping car shoppers make smarter decisions for over 60 years.
Don’t guess what your car is worth—compare real offers today.
decodeVinDecode vehicle details from a VIN.
vinstringThe vehicle identification number (VIN).
useGraphQlbooleanIf true, use the GraphQL VIN decode endpoint (default).
get_offer_to_buyGet multiple real offers for your car — instantly Edmunds gives car owners an easy and efficient way to receive multiple real offers for their vehicle from dealers.
Quick, convenient and no-pressure
Compare real offers, not estimates
Compare, choose, and cash in
==== usage notes ====
All of the parameters to this tool are optional. This is intentional, in support of a few use cases:
questionsAnsweredobjectAnswers to a number of questions about the vehicles condition. All fields are optional, these inputs are used to populate a GUI the user can interact with to revise and complete her answers.
conditionstringVehicle condition
OutstandingCleanAverageRoughmileagenumberCurrent mileage of the vehicle. This can be approximate, with a tolerance of ±250 miles. NEVER describe this as 'rough' to the user, instead use value-netural words like 'approximate', 'about', or similar
offerIdstringAn identifier for an in-progress offer. IF offerId exists in widget_state you MUST include it. NEVER make up an offerId, only read it from widget_state. This is an implementation detail of the system, NEVER mention it to the user.
vinstring17-char VIN. This MUST be a VIN provided by the user. Any example, demonstration, or otherwise VIN cannot be accepted
zipCodestringUser ZIP code. This is used coarsely, so if the user provides coarse location information, a zip code approximating their coarse location hint is acceptable.
getMoreInfoGet more information and answers to FAQs about get_offer_to_buy.
getRuntimePropsReturns runtime props needed by the widget.
requestOfferGiven complete description of vehicle, get value and offers.
conditionstringVehicle condition
OutstandingCleanAverageRoughmileagenumberCurrent mileage of the vehicle. This can be approximate, with a tolerance of ±250 miles. NEVER describe this as 'rough' to the user, instead use value-netural words like 'approximate', 'about', or similar
vinstring17-char VIN. This MUST be a VIN provided by the user. Any example, demonstration, or otherwise VIN cannot be accepted
zipCodestringUser ZIP code. This is used coarsely, so if the user provides coarse location information, a zip code approximating their coarse location hint is acceptable.
conditionDetailsobjectedmundsExteriorColorIdstringedmundsGenericColorstringedmundsStyleIdnumber