Odel
taxlocus data

taxlocus data

@ringzero787AI AgentsCC-BY-4.0Updated 1w ago

US sales tax for AI agents: rates, economic nexus, taxability, filing. Citation-backed.

Server endpointStreamable HTTP

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

TaxLocus Open Sales-Tax Dataset

Free, weekly-updated US sales-tax rate tables — the flat data behind TaxLocus, released as an open dataset for the community.

Data as of: 2026-05-19 · Refreshed weekly from the live TaxLocus corpus.

What this is

A clean, flat snapshot of US sales-tax rates and rules:

  • State base rates for all sales-tax states.
  • Local jurisdiction rates — ~14,000 counties, cities, parishes, boroughs, transit and special districts.
  • Economic-nexus thresholds — the per-state remote-seller registration triggers.
  • Taxability matrix — state × product-category taxable/exempt treatment.

Both CSV and JSON are provided for every table.

What this is not

This is the rate data only. The address-level lookup API, the polygon geometry that resolves an address to its jurisdiction stack, and the nexus tracking tools are the paid product at taxlocus.com. This dataset will tell you the rate for a named jurisdiction; it will not tell you which jurisdictions a given street address falls in.

Files & schema

All files live in data/.

state_rates — statewide base rates

columndescription
state2-letter state code
ratestatewide base sales-tax rate (decimal, e.g. 0.0625)

jurisdiction_rates — local jurisdiction rates

columndescription
state2-letter state code
jurisdiction_typecounty, city, parish, borough, transit, or special_district
namejurisdiction name
fips_codeCensus FIPS code, where available (may be blank)
ratelocal rate for the jurisdiction (decimal)

nexus_thresholds — economic-nexus thresholds

columndescription
state2-letter state code
sales_thresholdUSD sales threshold (may be blank)
transaction_thresholdtransaction-count threshold (may be blank)
logicsales_only, transactions_only, sales_or_count, or sales_and_count
measurement_periodprior_calendar_year, current_or_prior_cy, rolling_12_month, or prior_4_quarters

taxability — state × category taxability matrix

columndescription
state2-letter state code
categoryproduct-category code (e.g. food.grocery, clothing.general)
taxableTrue/False
treatmenttaxable, exempt, reduced_rate, exempt_with_cert, or partial

manifest.json

Generation date and per-file row counts for the current snapshot.

Payroll-tax open data (new — Plan 14)

Reference tables for US payroll tax — federal FICA/FUTA, state personal income tax (PIT) and SUTA wage bases, and local income tax where it exists (PA, OH, MD, IN, NYC, etc.). Same shape + CC-BY-4.0 licence; every row carries a citation_url to the authoritative source (IRS, state DOR, state UI agency) so any value can be verified or refreshed against the source. This is rate / reference data only — not a withholding-tax calculation engine, not the per-employer SUTA experience rate (which is state-assigned and not lookupable). Consumers compute their own withholding and take liability for it.

payroll_federal_rates

FICA (SS + Medicare + Additional Medicare 0.9% > $200k) and FUTA rates, wage bases, and credit max by year.

payroll_state_pit — state personal income tax (wage withholding)

columndescription
yeartax year
state2-letter state code
tax_typenone (no wage income tax) / flat / progressive
flat_rateflat rate (when tax_type='flat')
top_marginaltop marginal rate (when tax_type='progressive')
bracket_summaryoptional compact JSON of brackets
supplemental_ratesupplemental (bonus) withholding rate where published
citation_urlstate DOR / withholding guide
notesper-state nuance

payroll_state_suta — state unemployment-insurance wage base + rate range

columndescription
yeartax year
state2-letter state code
wage_baseannual SUTA wage base per employee
new_employer_ratenew-employer assigned rate (when published)
min_rate / max_ratebounds of the experience-rate range
citation_urlstate UI agency

Per-employer SUTA rates are NOT included — each employer's rate is experience-rated and assigned by the state UI agency annually.

payroll_local_income_tax — city / county / municipal income tax

columndescription
yeartax year
state2-letter state code
jurisdiction_typecity / county / municipality / school_district / township / borough
jurisdiction_namee.g. Philadelphia, Anne Arundel County, New York City
geoidFIPS / place GEOID when known
resident_rate / non_resident_ratewithholding rates
courtesy_withholdingwhether the state publishes a courtesy-withholding flag
citation_urlstate DOR / local agency

Local income tax coverage (3,662 rows, 8 states): PA (2,627 PSDs) · OH (890 munis: RITA + CCA + DOR self-administered) · IN (92 counties) · MD (24 counties) · MI (24 cities) · NY (NYC + Yonkers) · MO (KC + STL) · DE (Wilmington). The remaining ~8 states with some local income tax are not yet covered (KY, IA, OR, AL, CO, WV, KS, NJ-Newark); the other ~34 states have no local income tax at all. Read PAYROLL-COVERAGE.md before relying on this data for withholding — it documents every gap and the disclaimer in detail.

payroll_reciprocity — state income-tax reciprocity agreements

columndescription
state_a / state_bthe two states
directionmutual or a_to_b (one-way)
citation_urlstate DOR

Reciprocity exempts the non-resident state from withholding when an employee files the exemption form (e.g., PA REV-419, MD MW507).

License & attribution

This dataset is licensed under the Creative Commons Attribution 4.0 International (CC-BY-4.0) license — see LICENSE.

You are free to use, share, and adapt the data, including commercially, provided you give credit. Required attribution:

Sales-tax data by TaxLocushttps://taxlocus.com

Disclaimer

This dataset is provided for informational purposes only and is not tax advice. Sales-tax rates and rules change frequently, special districts and local boundaries are complex, and this snapshot may contain errors or omissions. Always verify against the relevant state Department of Revenue before relying on it for filing or remittance. TaxLocus makes no warranty as to accuracy, completeness, or fitness for any purpose.

Need address-level accuracy?

The free dataset gives you rates by named jurisdiction. To resolve a real street address to its exact jurisdiction stack — with geometry, product taxability, and economic-nexus tracking — use the TaxLocus API at taxlocus.com.