FREEDOM251

Freedom251 › Tax Engine Software

OpenSalesTax

Free plan Open source APILinuxMacSelf-hostedWeb

Visit OpenSalesTax Alternatives Pricing

What OpenSalesTax is

OpenSalesTax is a self-hosted API that calculates sales tax on US transactions using public data and per-state modules. The project says its modules cover 52 jurisdictions, while each published data dump includes all 48 jurisdictions that impose sales tax. The API calculates tax for line items and can break results down by state, county, city, or district. Documented item categories include general goods, clothing, groceries, prescription drugs, prepared food, and digital goods. Its data comes from Streamlined Sales Tax files and state Department of Revenue publications; it does not ingest paid tax data feeds. The engine can be installed from source or run with Docker. PostgreSQL is the default database, with MariaDB available as an optional extra. API access defaults to open access with per-IP rate limits; API-key mode uses an X-API-Key header and offers per-key limits and usage tracking. Release dumps use the SST quarterly file current at release time, and newer source data can be fetched and loaded. The project is pre-1.0, with no self-hosters or integrators listed in its public registry.

Who it suits

It suits developers or organizations that need a self-hosted API for calculating US sales tax on line items. Users should be prepared to verify tax results with the relevant state Department of Revenue before remitting.

What it does well

  • Free and open source under Apache 2.0
  • Breakdowns available by four jurisdiction levels
  • Includes documented categories for varied goods
  • Supports PostgreSQL and optional MariaDB
  • Offers API-key rate limits and usage tracking

What to know first

  • Sub-state stacking is incomplete for some areas
  • Calculations are not legal or tax advice
  • Project is pre-1.0
  • No self-hosters or integrators are listed

Limits

The project identifies incomplete sub-state tax stacking for Colorado home-rule cities and Louisiana parish-level collectors. The Docker runtime image lacks the psql client, so restoring data in the container requires adding that package or using the source-install route.

Plans

PlanBilled and limitsPrice
Free / open sourceApache 2.0 · self-hostable · US sales tax calculation APIFree
Free self-hosted engineDocker or source deployment · REST API · hosting and maintenance are your responsibilityFree

As github.com lists them, read 4 Oct 2026. The maker's own page has the final word.

Getting started

  1. Open the OpenSalesTax GitHub project.
  2. Install the engine from source or run it with Docker.
  3. Set up PostgreSQL, or add optional MariaDB support.
  4. Load a published data dump or follow the project instructions to fetch and load newer source data.
  5. Use the API with open access and per-IP rate limits, or configure API-key access with an X-API-Key header.

OpenSalesTax is a self-hosted API for computing U.S. sales tax from public jurisdiction data. It is best for developers and small teams willing to run infrastructure and maintain tax inputs; businesses that need fully managed, audit-ready coverage should look elsewhere.

Overview

The service prices individual line items and can return tax apportioned across state, county, city, and district jurisdictions. Its documented categories cover general merchandise, clothing, groceries, prescription drugs, prepared food, and digital goods, giving implementers useful distinctions for common transaction types.

The project reports modules for 52 jurisdictions, with every published dump loading the 48 jurisdictions that levy sales tax. It builds those datasets from Streamlined Sales Tax files and state Department of Revenue publications rather than paid commercial feeds. That keeps the stack open and controllable, but users remain responsible for checking outcomes with the relevant state authority before remitting; the project expressly disclaims legal and tax advice.

Key features

Deployment and database choices

You can install the engine from source or run it with Docker. PostgreSQL is the default database, while MariaDB is supported as an optional extra. This is a practical fit for teams already operating those systems, but it is not a managed endpoint that removes database administration.

Authentication and traffic controls

Out of the box, access is open and limited per IP. An API-key mode instead requires an X-API-Key header and adds limits and usage tracking per key. Open access is convenient for internal prototypes; production integrations will generally want keyed access for attribution and more targeted throttling.

Data maintenance

Release dumps are tied to the Streamlined Sales Tax quarterly file current when each release is made. Documentation also describes fetching and loading newer source data, so operators can establish their own refresh process rather than waiting for a new application release.

Known calculation gaps

The project acknowledges incomplete sub-state stacking for Colorado home-rule cities and for Louisiana parish-level collectors. Those exceptions are material for merchants shipping into affected areas and rule out treating the API as a universal authority without validation.

Container caveat

The Docker runtime does not include the psql client. Restoring data therefore fails inside the container unless you add that package or use the source-install route, an operational wrinkle to resolve before standardizing deployments.

Pricing

Free / open source — free. The Apache 2.0, self-hostable plan provides the U.S. sales-tax calculation API at no charge. There are no paid tiers, seat allowances, trial windows, or renewal terms to weigh. The trade-off is operational: you supply hosting, database administration, data refreshes, and validation, and you absorb the impact of the documented jurisdiction gaps.

Platforms

OpenSalesTax is delivered as an API and can be self-hosted from source or with Docker. PostgreSQL is the standard persistence layer, with optional MariaDB support. It is therefore aimed at backend teams rather than buyers seeking a hosted web console.

Who it's for

Choose it for an engineering-led product that needs a no-license-cost U.S. sales-tax calculator, wants control over data and deployment, and can review rates against state guidance. It also suits contributors interested in reporting incorrect rates or adopting a state through the project's contribution process.

Look beyond it if your operation cannot maintain a database and refresh pipeline, needs complete local-tax stacking in Colorado and Louisiana, or wants a provider to assume compliance and filing responsibility. The public users registry currently shows no listed self-hosters or integrators, and the project is pre-1.0, so organizations requiring an established adoption record should factor that in.

Pros and cons

  • Pro: No license fee and Apache 2.0 terms make the calculator inexpensive to embed and modify.
  • Pro: State, county, city, and district breakdowns provide more actionable output than a single combined rate.
  • Pro: API-key limits and usage tracking support controlled production access.
  • Con: Colorado home-rule and Louisiana parish stacking is explicitly incomplete, which can affect destination-level accuracy.
  • Con: Hosting, PostgreSQL operations, source-data loading, and tax verification remain your responsibility.
  • Con: Docker restores need an added psql client or a source installation.

Alternatives

Vatstack is the better choice when you want an API with a web option and a free Developer plan offering unlimited quotes and dummy validations; its Launch plan starts at $0 per month with a stated allowance.

ShipVAT suits teams preferring a hosted API/web product, a free-forever tier, and a 100-call monthly allowance with a trial option.

VAT Engine is an alternative for buyers willing to use free access during an active alpha, with availability, limits, support, pricing, and features subject to change.

Zamp fits teams seeking a 30-day sandbox and a paid U.S. compliance offering aimed at scaling organizations.

Kintsugi is aimed at global nexus monitoring, exposure auditing, and risk assessment rather than only a self-hosted calculation engine.

CCH SureTax is for organizations wanting technology with optional filing and remittance, including a fully outsourced tier.

CCH Tagetik is a paid self-hosted and web platform sold through demo or quote discussions.

Complyt is a paid API and web alternative.

Browse more options in Tax Engine Software.

Verdict

OpenSalesTax is a strong starting point for technically capable teams that value open-source control and zero licensing cost for U.S. sales-tax calculations. Choose it for jurisdiction-level API output and ownership of the deployment; choose another provider when incomplete local stacking, pre-1.0 maturity, or the burden of maintaining tax data creates unacceptable compliance risk.

Verdict

OpenSalesTax provides a self-hostable sales-tax API with jurisdiction breakdowns and configurable access modes. Its project notes incomplete stacking in some locations and advises checking results with state tax authorities.

Questions

How much does OpenSalesTax cost?

The Free / open source plan costs nothing. The project is available under Apache 2.0.

Can I host OpenSalesTax myself?

Yes. It can be installed from source or run with Docker. PostgreSQL is required by default, with MariaDB available as an optional extra.

What does the API calculate?

It calculates sales tax for US transaction line items and can return results by state, county, city, or district jurisdiction.

What data does it use?

It uses Streamlined Sales Tax files and state Department of Revenue publications. The project says it does not ingest paid tax data feeds.

Does it use API keys?

Open access with per-IP rate limiting is the default. API-key mode uses an X-API-Key header and supports per-key rate limits and usage tracking.

Is OpenSalesTax tax advice?

No. The project says its calculations are not legal or tax advice and recommends checking results with the relevant state Department of Revenue before remitting.

Facts from OpenSalesTax's own pages

Adoption status
The public users registry says there are no listed self-hosters or integrators yet and that OpenSalesTax is pre-1.0. · github.com, 4 Oct 2026
Advice disclaimer
The project describes its output as calculation only, not legal or tax advice, and tells users to verify results with their state revenue department. · github.com, 15 Oct 2026
API access
Authentication defaults to open access with per-IP rate limiting, while an API-key mode requires an X-API-Key header and supports per-key rate limits and usage tracking. · github.com, 4 Oct 2026
API endpoints
The documented API exposes health, jurisdiction coverage, ZIP-based rates, and POST tax calculations under version 1 routes. · github.com, 15 Oct 2026
Calculations
The API calculates tax for line items and can return a breakdown by state, county, city, or district jurisdiction. · github.com, 4 Oct 2026
Contributions
Contributors must sign commits using the Developer Certificate of Origin process. · github.com, 15 Oct 2026
Coverage
The project says it has modules for 52 jurisdictions, with all 48 sales-taxing jurisdictions loaded into each published data dump. · github.com, 4 Oct 2026
Coverage limitation
Colorado home-rule cities and Louisiana parish-level collectors are not fully represented, so sub-state stacking is incomplete there. · github.com, 15 Oct 2026
Database support
MariaDB is available through an optional installation extra, but the bundled release dump is PostgreSQL COPY format. · github.com, 15 Oct 2026
Data refresh
Operators can bypass the bundled dump and fetch and load newer state data directly from upstream sources. · github.com, 15 Oct 2026
Data-release limitation
Release dumps before v0.59.0 omitted 23 taxing states and require restoration from a corrected asset. · github.com, 15 Oct 2026
Data sources
The project uses Streamlined Sales Tax files and state Department of Revenue publications, and says it does not ingest paid tax data feeds. · github.com, 4 Oct 2026
Deployment
Users can install from source with Poetry and PostgreSQL or run the stack with Docker Compose. · github.com, 15 Oct 2026
Docker limitation
The published runtime image lacks the psql client, so the documented data-restore command fails in the container until that package is added. · github.com, 15 Oct 2026
Holiday rules
The engine includes holiday-aware calculations, illustrated by a Texas clothing exemption example. · github.com, 15 Oct 2026
Hosting
The engine can be installed from source or run with Docker and requires PostgreSQL by default; MariaDB support is available as an optional extra. · github.com, 4 Oct 2026
Independent limitation
WiserReview says users must host and update the engine, handle remittance themselves, and that marketplace and multi-vendor allocation are not covered. · wiserreview.com, 15 Oct 2026
Independent pricing assessment
WiserReview lists the engine and WooCommerce plugin at $0 software cost, with hosting and maintenance left to the user. · wiserreview.com, 15 Oct 2026
Item categories
Documented categories include general, clothing, groceries, prescription drugs, prepared food, and digital goods. · github.com, 4 Oct 2026
Jurisdiction detail
Calculation responses break tax into state, county, city, and district jurisdictions so totals can be reconciled. · github.com, 15 Oct 2026
License
The engine is released under the Apache License 2.0. · github.com, 15 Oct 2026
Limitations
The project identifies incomplete sub-state tax stacking for Colorado home-rule cities and Louisiana parish-level collectors. · github.com, 4 Oct 2026
Magento integration
The Magento 2 module supports U.S.-destination, USD checkouts and can fail back to Magento tax tables when the engine is unavailable. · packagist.org, 15 Oct 2026
Maker identity
The repository identifies Eric Osterberg as the initial project maintainer responsible for direction and license decisions. · github.com, 15 Oct 2026

Where OpenSalesTax stands on Freedom251

Look at these too