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

Questions?

We're always happy to help with code or other questions you might have! Email us.