NAV Navbar

MonroneyLabels Docs

  • Home
  • Quickstart
  • CDK Global
  • API
  • Add MonroneyLabels on vAuto
  • Fully Automatic Brands
  • 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 http://api.monroneylabels.com/vins/window_sticker_color.json?year=#{year}&make=#{make}&vin=#{vin}&single_access_token=#{api-token}

    For example:

    GET http://api.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.