NAV Navbar

MonroneyLabels Docs

  • Home
  • Quickstart
  • CDK Global
  • Data Feed
  • API
  • Add MonroneyLabels on vAuto
  • Fully Automatic Brands
  • VIN Decode API

    MonroneyLabels.com provides an API for users to decode VIN numbers. This API is available via POST or GET using the application/json format. Users must be already registered and provide an API token in order to use these services.

    VIN Decode

    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.

    HTTP Request

    GET http://api.monroneylabels.com/cars/vin.json?single_access_token=#{api-token}&car[vin]=#{vin}

    For example:

    GET http://api.monroneylabels.com/cars/vin.json?single_access_token=AqhkvxefpNKiewRVpSgI&car[vin]=1GCVKREH3FZ413294

    Example Response:

    {
      "redirect_to": "/cars/210461-2015-chevrolet-silverado-1500",
      "car": {
        "sticker": {
          "pdf": "http://monroneylabels.com/cars/210461-2015-chevrolet-silverado-1500/window_sticker.pdf",
          "jpg": "http://monroneylabels.com/cars/210461-2015-chevrolet-silverado-1500/window_sticker.jpg",
          "dimensions": [
            1432,
            1778
          ]
        },
        "miles": null,
        "comments": null,
        "start_price": "0.0",
        "url": null,
        "vin": "1GCVKREH3FZ413294",
        "get_light_color": "green"
      }
    }

    Query Parameters

    Parameter Example Description
    single_access_token AqhkvxefpNKiewRVpSgI Session token or API token
    car[vin] 1GCVKREH3FZ413294 The vehicles's 17-digit VIN number

    Response Attributes (Root)

    Parameter Description
    redirect_to The MonroneyLabels URL to view the window sticker

    Response Attributes (Car)

    Parameter Description
    sticker URL to JPG and PDF window stickers
    dimensions Size of the JPG window sticker image [width x height]
    comments Comments (provided by dealer)
    miles Vehicle mileage (provided by dealer)
    url URL of Vehicle Description Page (provided by dealer)
    vin VIN Number

    Icon

    We recommend linking this icon to the window sticker.

    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

    Example2


    Pricing

    All accounts are charged per VIN decode. After that, additional hits on the same VIN are free. At the end of the month, you will receive an itemized list of all VIN's decoded. You will only be charged for decodes that are complete and fully automatic. You will not be charged for incomplete VIN decodes.


    Questions?

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