Vin Decode with Oauth Client

MonroneyLabels.com can uses the Oauth protocol for authentication. Here's how to decode a car once you have the access token.

Access the VIN Decode API

Send the car attributes to add a vehicle instantly to the user's inventory. A 17-digit VIN number is required. If the decode is unsuccessful, an error message is returned.

Access the VIN Decode API and add an Authorization header, with the value of Bearer {access_token}. Do not send a single_access_token parameter.

HTTP Request

GET https://api.monroneylabels.com/cars/vin.json?car[vin]={vin}

HEADER Bearer {access_token}

Example Response:

{
  "redirect_to": "/cars/11967080-2015-chevrolet-silverado-1500",
  "car": {
    "car_id": "11967080-2015-chevrolet-silverado-1500",
    "sticker": {
      "pdf": "https://api.monroneylabels.com/cars/11967080-2015-chevrolet-silverado-1500/window_sticker.pdf?cfl=3437821978",
      "jpg": "https://api.monroneylabels.com/cars/11967080-2015-chevrolet-silverado-1500/window_sticker.jpg?cfl=3437821978",
      "mobile": "https://api.monroneylabels.com/cars/11967080-2015-chevrolet-silverado-1500/window_sticker.html",
      "dimensions": [
        1432,
        1778
      ]
    },
    "miles": null,
    "favorite": false,
    "comments": null,
    "start_price": "0.0",
    "url": null,
    "vin": "1GCVKREH3FZ413294",
    "get_light_color": "green",
    "build_data?": true,
    "year": 2015,
    "make": "Chevrolet",
    "model": "Silverado 1500",
    "is_paid?": true,
    "should_be_green": true,
    "mobile_comment": null,
    "created_at": "2024-06-27 00:19:00 -0400"
  }
}

Query Parameters

access_token is the access token provided for your Oauth client..

car[vin] is the vehicle's 17-digit VIN number.

Response Attributes

Use the redirect_to attribute if you want to redirect the consumer to a MonroneyLabels-generated webpage containing the window sticker. From this webpage, the consumer will be able to email the window sticker and print out a PDF version.

year and make represent the vehicle's model-year and manufacturer name

The sticker attribute holds the URL's to JPG and PDF window stickers. There is also a mobile version that is formatted for handheld devices.

comments, miles, url and start_price are all attributes supplied by the dealer and they will be blank by default.

best_trim_name and best_style_name are for internal use only. They are not recommended for customer use. The information in these fields might not match what's on the window sticker.

The get_light_color attribute will be "green" if the window sticker data is complete.

The build_data? attribute is true if the window sticker is available in replica format, and false otherwise. In the case where we have both the replica format and the original OEM format, use the dimensions attribute to figure out which one it is.

Icon

We recommend linking this icon to the window sticker.

Placement

Use the following guidelines to place the window sticker:

Only on used cars.
On every Vehicle Description Page(VDP) and Search Results Page(SRP).
Next to the Carfax logo