List VIN's API

MonroneyLabels.com provides an API for users to get the list of cars already decoded by a specific account. This API is available via GET using the application/json format.

List VIN's

Include the user’s Monroneylabels ID to get a paginated list of all their cars. The most recent VIN decodes appear first.

HTTP Request

GET https://monroneylabels.com/users/#{user_id}/cars/list.js?page=#{page}&per_page=#{per_page}&single_access_token=#{api-token}

For example:

GET https://monroneylabels.com/users/2960/cars/list.js?page=1&per_page=5&single_access_token=AqhkvxefpNKiewRVpSgI

Example Response:

{
  "user": {
    "id": 2960,
    "first_name": "Nicole",
    "last_name": "Beguesse",
    "company": "My Dealership",
    "last_synced_at": "20240423",
    "modified_price_per_vin": "0.0",
    "cars": [
      {
        "car_id": "73711-2015-chevrolet-silverado-1500",
        "sticker": {
          "pdf": "https://monroneylabels.com/cars/73711-2015-chevrolet-silverado-1500/window_sticker.pdf?cfl=4816546150",
          "jpg": "https://monroneylabels.com/cars/73711-2015-chevrolet-silverado-1500/window_sticker.jpg?cfl=4816546150",
          "mobile": "https://monroneylabels.com/cars/73711-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": "2017-10-31 19:50:30 -0400"
      },
      {
        "car_id": "45258-2015-chevrolet-silverado-2500hd",
        "sticker": {
          "pdf": "https://monroneylabels.com/cars/45258-2015-chevrolet-silverado-2500hd/window_sticker.pdf?cfl=4654073856",
          "jpg": "https://monroneylabels.com/cars/45258-2015-chevrolet-silverado-2500hd/window_sticker.jpg?cfl=4654073856",
          "mobile": "https://monroneylabels.com/cars/45258-2015-chevrolet-silverado-2500hd/window_sticker.html",
          "dimensions": [
            1432,
            1778
          ]
        },
        "miles": 5890,
        "favorite": false,
        "comments": null,
        "start_price": "0.0",
        "url": null,
        "vin": "1GC1KWE84FF168696",
        "get_light_color": "green",
        "build_data?": true,
        "year": 2015,
        "make": "Chevrolet",
        "model": "Silverado 2500HD",
        "is_paid?": true,
        "should_be_green": true,
        "mobile_comment": null,
        "created_at": "2017-04-24 14:41:54 -0400"
      },
      {
        "car_id": "44436-2016-chevrolet-silverado-1500",
        "sticker": {
          "pdf": "https://monroneylabels.com/cars/44436-2016-chevrolet-silverado-1500/window_sticker.pdf?cfl=4653141854",
          "jpg": "https://monroneylabels.com/cars/44436-2016-chevrolet-silverado-1500/window_sticker.jpg?cfl=4653141854",
          "mobile": "https://monroneylabels.com/cars/44436-2016-chevrolet-silverado-1500/window_sticker.html",
          "dimensions": [
            1432,
            1778
          ]
        },
        "miles": null,
        "favorite": false,
        "comments": null,
        "start_price": "0.0",
        "url": null,
        "vin": "3GCUKTEJ9GG204414",
        "get_light_color": "green",
        "build_data?": true,
        "year": 2016,
        "make": "Chevrolet",
        "model": "Silverado 1500",
        "is_paid?": true,
        "should_be_green": true,
        "mobile_comment": null,
        "created_at": "2017-04-17 14:12:54 -0400"
      },
      {
        "car_id": "17116-2016-bmw-i8",
        "sticker": {
          "pdf": "https://monroneylabels.com/cars/17116-2016-bmw-i8/window_sticker.pdf?cfl=4623849085",
          "jpg": "https://monroneylabels.com/cars/17116-2016-bmw-i8/window_sticker.jpg?cfl=4623849085",
          "mobile": "https://monroneylabels.com/cars/17116-2016-bmw-i8/window_sticker.html",
          "dimensions": [
            1432,
            1778
          ]
        },
        "miles": null,
        "favorite": false,
        "comments": null,
        "start_price": "0.0",
        "url": null,
        "vin": "WBY2Z2C5XGV675562",
        "get_light_color": "yellow",
        "build_data?": false,
        "year": 2016,
        "make": "BMW",
        "model": "i8",
        "is_paid?": true,
        "should_be_green": false,
        "mobile_comment": "Sorry, we don't have window sticker data for this vehicle. Please try another one.",
        "created_at": "2016-05-13 13:20:03 -0400"
      }
    ]
  }
}

Query Parameters

Parameter Example Description
user_id 2960 User's MonroneyLabels ID
per_page 5 The number of cars to list per page
page 1 The page to retrieve
single_access_token AqhkvxefpNKiewRVpSgI Session token or API token

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:

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