Light Color API
MonroneyLabels.com provides an API for users to predict whether build data is available for a vehicle before decoding it. It will return either green, yellow, or red:
Response | Meaning |
---|---|
"green" | Build data available -- The window sticker will be fully automatically decoded. There's nothing more you need to do to display the completed, accurate window sticker. |
"yellow" | Basic data available -- The window sticker is not fully automatic and must be manually decoded. The user will still get the make, model, style, MSRP, and standard options. However they will not get the list of installed VIN-specific factory options. Instead they will get the list of available option packages and the user must manually check off the options that are on the car to get the completed sticker. |
"red" | No data available -- We couldn't decode the year and make from the VIN. You might get red if you try to decode motorcycles, vehicles outside the USA, etc. |
This API is the most precise way to predict the VIN decode results.
Get the Light Color
Send either the car's year and make, or the VIN. For most accurate results, send all three parameters.
HTTP Request
GET https://monroneylabels.com/vins/window_sticker_color.json?year=#{year}&make=#{make}&vin=#{vin}&single_access_token=#{api-token}
For example:
GET https://monroneylabels.com/vins/window_sticker_color.json?year=1999&make=GMC&vin=1GTEK19T9XE502201&single_access_token=AqhkvxefpNKiewRVpSgI
Example Response:
{"color":"green"}
Query Parameters
Parameter | Example | Description |
---|---|---|
year | 2016 | The car's year |
make | Dodge | The car's make (see note below) |
vin | 1GNGK46K69R216394 | The car's VIN number |
single_access_token | AqhkvxefpNKiewRVpSgI | Session token or API token |
Response Attributes
Parameter | Description |
---|---|
color | "green", "yellow" or "red" depending on data availability |
Spelling
The car's make must be correctly spelled and capitalized. Please use the spelling list below:
Acura Alfa Romeo Aston Martin Audi Bentley BMW Buick Cadillac Chevrolet Chrysler Dodge Ferrari FIAT Ford GMC Honda HUMMER Hyundai INFINITI Isuzu Jaguar Jeep Kia Lamborghini Land Rover Lexus Lincoln Maserati Mazda McLaren Mercedes-Benz MINI Mitsubishi Nissan Oldsmobile Plymouth Pontiac Porsche Ram Rolls-Royce Saab Saturn Scion Smart Subaru Tesla Toyota Volkswagen