receipt-tax-codes

Tax code lookup data for 15+ US retailers. Find what N, X, O, T, and other tax codes mean on receipts from Walmart, Target, Costco, CVS, and more.

Built by CheckoutReceipt.com — free receipt generator with 100+ store-specific templates.

Install

npm install receipt-tax-codes

Quick Start

const { lookupCode, getRetailer, searchCode } = require("receipt-tax-codes");

// What does "N" mean on a Walmart receipt?
lookupCode("walmart", "N");
// => "Non-taxable item (grocery staples, unprepared food)"

// Get all tax codes for Target
getRetailer("target");
// => { name: "Target", codes: { N: "...", X: "...", O: "...", ... } }

// What does "X" mean across all retailers?
searchCode("X");
// => [{ retailer: "walmart", name: "Walmart", meaning: "..." }, ...]

Supported Retailers

Retailer	Key	Codes
Walmart	walmart	N, X, O, T, F, H, P
Target	target	N, X, O, F, H, A, C
Costco	costco	A, E, N, F, A+
CVS Pharmacy	cvs	N, T, F, FS, H
Kroger	kroger	N, T, X, F, MR
Walgreens	walgreens	N, T, F, FS, H
Home Depot	homeDepot	N, T, X
Lowe's	lowes	N, T, X
Amazon	amazon	N, T, X, E
Best Buy	bestBuy	T, N, E
Trader Joe's	traderJoes	N, T, F
Whole Foods	wholeFoods	N, T, F, A
ALDI	aldi	N, T, F
Safeway / Albertsons	safeway	N, T, F, CRV
Publix	publix	N, T, F

API

lookupCode(retailer, code)

Returns the meaning of a specific tax code at a specific retailer, or null if not found.

lookupCode("costco", "A");
// => "Taxable at standard rate (general merchandise)"

getRetailer(retailer)

Returns the full retailer object with name and all codes, or null if not found. Handles common aliases ("home depot" resolves to "homeDepot", "albertsons" resolves to "safeway").

getRetailer("home depot");
// => { name: "Home Depot", codes: { N: "...", T: "...", X: "..." } }

getRetailers()

Returns an array of all available retailer keys.

getRetailers();
// => ["walmart", "target", "costco", "cvs", ...]

searchCode(code)

Searches across all retailers for a specific tax code and returns an array of matches.

searchCode("F");
// => [
//   { retailer: "walmart", name: "Walmart", meaning: "Food item (may be taxed at reduced rate...)" },
//   { retailer: "target", name: "Target", meaning: "Food item (reduced tax rate...)" },
//   ...
// ]

Common Tax Code Reference

Code	General Meaning
N	Non-taxable (grocery staples, exempt items)
X	Taxable at standard state/local rate
T	Taxable (alias for X at some retailers)
O	Zero-rated / tax-exempt
F	Food (may have reduced rate)
H	Health / pharmacy
A	Alcohol

Tax codes vary by state and retailer. This package provides general guidance — always check your local tax regulations for specifics.

Use Cases

• Receipt parsing — Automatically categorize line items as taxable or exempt
• Expense tracking — Identify tax-deductible items on receipts
• Receipt generation — Apply correct tax codes when creating receipt templates
• Financial tools — Build tax calculators with retailer-specific logic
• Education — Help consumers understand their receipts

Related

• CheckoutReceipt.com — Free receipt generator with store-specific templates
• Receipt Tax Code Lookup — Chrome extension for quick tax code lookups

License

MIT