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).
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: 289Step 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,010Step 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 savedStep 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 fileStep 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
sticker_not_available(404): the carmaker has no original sticker for this VIN. Check/availabilityfirst; it costs the same single call and tells you up front.plan_required(403):/stickerneeds Starter or above. Upgrade the same key.quota_exceeded/rate_limited(429): read theX-Quota-RemainingandRetry-Afterheaders.invalid_vin(400) andunknown_vin(404): typos such as O for 0 or I for 1. Calls that fail before they are counted are free.
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