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:
- Only on used cars.
- On every Vehicle Description Page(VDP) and Search Results Page(SRP).
- Next to the Carfax logo