Skip to content
StickerByVIN
Menu

Get a car's window sticker by VIN in JavaScript (Node)

Pull the original Monroney label for a VIN, with total MSRP, every option and package with its price, and the PDF, in a few lines of JavaScript. 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

npm install github:PRIMITIFA/stickerbyvin-js   # npm release coming: npm install stickerbyvin
export SBV_KEY=sbv_live_...   # Windows PowerShell: $env:SBV_KEY="sbv_live_..."

The stickerbyvin (JavaScript) 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. Run it as an ES module (.mjs, or "type": "module") so top-level await works.

import { StickerByVIN } from 'stickerbyvin';

const sbv = new StickerByVIN(); // reads process.env.SBV_KEY
const a = await sbv.availability('1FTFW5L85TKD66889');

const v = a.vehicle;
console.log(v.year, v.make, v.model, v.trim);
console.log('Original sticker on file:', a.originalSticker.onFile);
console.log('Source:', a.originalSticker.source);
console.log('Calls left this month:', sbv.quotaRemaining);

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: 277

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. The package ships TypeScript types for every field.

const { sticker: st } = await sbv.sticker('1FTFW5L85TKD66889');
const usd = (n) => '$' + n.toLocaleString('en-US');

console.log(st.description, '|', st.exteriorColor);
console.log(`Base ${usd(st.basePrice)} + options ${usd(st.totalOptions)} + destination ${usd(st.destination)} = MSRP ${usd(st.totalMsrp)}`);
for (const o of st.options) console.log(`  ${o.name.padEnd(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. stickerPdf() downloads it as a Uint8Array.

import { writeFile } from 'node:fs/promises';

const pdf = await sbv.stickerPdf('1FTFW5L85TKD66889');
await writeFile('window-sticker.pdf', pdf);
console.log(pdf.length, 'bytes saved');

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

2016433 bytes saved

Step 4: Loop over a list of VINs

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 { StickerByVINError } from 'stickerbyvin';

const vins = ['1FTFW5L85TKD66889', '1HGCM82633A004352'];
for (const vin of vins) {
  const a = await sbv.availability(vin);
  const name = `${a.vehicle.year} ${a.vehicle.make} ${a.vehicle.model}`;
  if (!a.originalSticker.onFile) { console.log(vin, name, '-> no original sticker on file'); continue; }
  try {
    const { sticker } = await sbv.sticker(vin);
    console.log(vin, name, '-> MSRP', sticker.totalMsrp, `(${sticker.options.length} options)`);
  } catch (e) {
    if (e instanceof StickerByVINError) console.log(vin, '->', e.code);
    else throw e;
  }
}

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

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

Step 5: Without the package: plain fetch

It is a normal JSON API with bearer auth, so built-in fetch on Node 18+, Deno, Bun or Cloudflare Workers is enough. Keep the key on your server, never in browser code.

const res = await fetch('https://stickerbyvin.com/api/v1/sticker?vin=1FTFW5L85TKD66889', {
  headers: { Authorization: `Bearer ${process.env.SBV_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(res.headers.get('x-quota-remaining'), 'calls left');
console.log(data.sticker.totalMsrp, data.source);

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

271 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 Python Full API reference