NAV Navbar

MonroneyLabels Docs

  • MonroneyLabels Docs
  • Quickstart
  • CDK Global
  • 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://monroneylabels.com/cars/vin.json?single_access_token=#{api-token}&car[vin]=#{vin}

    For example:

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

    Example Response:

    {
      "redirect_to": "/cars/841668-2015-chevrolet-silverado-1500",
      "car": {
        "car_id": "841668-2015-chevrolet-silverado-1500",
        "sticker": {
          "pdf": "http://monroneylabels.com/cars/841668-2015-chevrolet-silverado-1500/window_sticker.pdf",
          "jpg": "http://monroneylabels.com/cars/841668-2015-chevrolet-silverado-1500/window_sticker.jpg",
          "mobile": "http://monroneylabels.com/cars/841668-2015-chevrolet-silverado-1500/window_sticker.html",
          "dimensions": [
            1432,
            1778
          ]
        },
        "miles": null,
        "comments": null,
        "start_price": "0.0",
        "url": null,
        "vin": "1GCVKREH3FZ413294",
        "get_light_color": "green",
        "build_data?": true,
        "year": 2015,
        "make": "Chevrolet",
        "model": "Silverado 1500",
        "best_style_name": "4WD Double Cab 143.5\" LT w/1LT",
        "best_trim_name": "LT",
        "is_paid?": true,
        "should_be_green": true,
        "mobile_comment": null
      }
    }

    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
    year Vehicle year
    make Vehicle manufacturer
    best_trim_name Vehicle trim
    best_style_name Vehicle trim style
    sticker URL's to JPG and PDF window stickers
    comments Comments (provided by dealer)
    miles Vehicle mileage (provided by dealer)
    url URL of Vehicle Description Page (provided by dealer)
    get_light_color 'green' if the window sticker data is complete. See Light Color
    build_data? true if window sticker is available in a replica format, false otherwise
    start_price For internal use

    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


    Questions?

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