Skip to content
StickerByVIN
Menu

Get a car's window sticker by VIN in Python

Pull the original Monroney label for a VIN, with total MSRP, every option and package with its price, and the PDF, in about 10 lines of Python. Every snippet below was run against the live API with a real 2026 Ford F-150 Lariat, and the output shown is what it printed.

Step 0: get a free API key

50 calls a month, no card, and the key arrives in about 30 seconds. Availability and decode work on the free plan. Sticker data (options, prices, PDF) needs Starter ($49/month, 1,000 calls).

Get my free API key Plans

Install

pip install git+https://github.com/PRIMITIFA/stickerbyvin-python   # PyPI release coming: pip install stickerbyvin
export SBV_KEY=sbv_live_...   # Windows PowerShell: $env:SBV_KEY="sbv_live_..."

The stickerbyvin (Python) package is a thin, dependency-free wrapper (source on GitHub). Each step below also shows the plain HTTP call, so you can skip the package.

Step 1: Check whether the original sticker is on file

Call /availability first. It decodes the VIN and tells you whether the carmaker has the original sticker. It works on every plan, the free one included, and costs one call.

from stickerbyvin import StickerByVIN

sbv = StickerByVIN()  # reads the SBV_KEY environment variable
a = sbv.availability("1FTFW5L85TKD66889")

v = a["vehicle"]
print(v["year"], v["make"], v["model"], v["trim"])
print("Original sticker on file:", a["originalSticker"]["onFile"])
print("Source:", a["originalSticker"]["source"])
print("Calls left this month:", sbv.quota_remaining)

Output (real run, 2026-11-18):

2026 FORD F-150 Lariat
Original sticker on file: True
Source: Ford Motor Company (windowsticker.forddirect.com)
Calls left this month: 289

Step 2: Get the sticker: MSRP and every option with its price

/sticker returns the parsed original label: base price, options, destination, total MSRP, colours, engine, fuel economy and standard equipment. It needs Starter or above.

s = sbv.sticker("1FTFW5L85TKD66889")
st = s["sticker"]

print(st["description"], "|", st["exteriorColor"])
print(f"Base ${st['basePrice']:,} + options ${st['totalOptions']:,} + destination ${st['destination']:,} = MSRP ${st['totalMsrp']:,}")
for o in st["options"]:
    print(f"  {o['name']:<32} {o['priceText']}")

Output (real run, 2026-11-18):

2026 F-150 4X4 SUPERCREW | Agate Black Metallic
Base $63,360 + options $6,395 + destination $2,795 = MSRP $72,550
  Equipment Group 501A             $2,670
  3.55 Electronic Lock Rr Axle     No charge
  7100# GVWR Package               Included
  Lariat Black Appearance Pkg      $1,475
  Tow/Haul Package                 $1,010

Step 3: Save the original PDF

Each sticker response has a signed PDF link that is valid for one hour. sticker_pdf() fetches it and saves the file.

import os

sbv.sticker_pdf("1FTFW5L85TKD66889", "window-sticker.pdf")
print(os.path.getsize("window-sticker.pdf"), "bytes saved")

Output (real run, 2026-11-18):

2016433 bytes saved

Step 4: Run a list of VINs into a CSV

Check availability before you pull, so you only call /sticker for VINs that have one. The second VIN below, a 2003 Honda Accord, has no original sticker on file.

import csv
from stickerbyvin import StickerByVINError

vins = ["1FTFW5L85TKD66889", "1HGCM82633A004352"]
with open("stickers.csv", "w", newline="") as f:
    w = csv.writer(f)
    w.writerow(["vin", "vehicle", "msrp", "options"])
    for vin in vins:
        a = sbv.availability(vin)
        name = f"{a['vehicle']['year']} {a['vehicle']['make']} {a['vehicle']['model']}"
        if not a["originalSticker"]["onFile"]:
            print(vin, name, "-> no original sticker on file")
            continue
        try:
            st = sbv.sticker(vin)["sticker"]
        except StickerByVINError as e:
            print(vin, "->", e.code)
            continue
        w.writerow([vin, name, st["totalMsrp"], "; ".join(o["name"] for o in st["options"])])
        print(vin, name, "-> MSRP", st["totalMsrp"])

Output (real run, 2026-11-18):

1FTFW5L85TKD66889 2026 FORD F-150 -> MSRP 72550
1HGCM82633A004352 2003 HONDA Accord -> no original sticker on file

Step 5: Without the package: plain requests

It is a normal JSON API with bearer auth. If you use Python’s built-in urllib, set a User-Agent header: our firewall blocks the default Python-urllib one.

import os
import requests

r = requests.get(
    "https://stickerbyvin.com/api/v1/sticker",
    params={"vin": "1FTFW5L85TKD66889"},
    headers={"Authorization": "Bearer " + os.environ["SBV_KEY"]},
    timeout=30,
)
data = r.json()
if not r.ok:
    raise SystemExit(f'{data["error"]["code"]}: {data["error"]["message"]}')
print(r.headers["X-Quota-Remaining"], "calls left")
print(data["sticker"]["totalMsrp"], data["source"])

Output (real run, 2026-11-18):

270 calls left
72550 Ford Motor Company (windowsticker.forddirect.com)

Error codes you should handle

Which VINs have an original sticker?

Originals come straight from the carmaker for Ford and Lincoln, GM (Chevrolet, GMC, Buick, Cadillac) 2022 and newer, most Jeep, Ram, Dodge and Chrysler from 2017 on, and Subaru 2021 and newer. Our 84-VIN availability study has the real hit rates.

Using an AI agent instead?

The same key works with our MCP server at https://stickerbyvin.com/api/v1/mcp. Send it as Authorization: Bearer or append ?api_key=. The tools are check_window_sticker (free) and get_original_sticker (1 call). MCP setup.

Ready to try it on your own VINs?

Get a free key, run Step 1, and you'll know in one call whether the original sticker is on file.

Get a free API key Same guide in JavaScript Full API reference