O

Tax Engine Software

OpenSalesTax: Free, Open-Source US Sales Tax API

github.com · checked 15 Oct 2026

Open-source API for calculating US sales tax by jurisdiction and item category.

How it plugs in

—Public API
YesOpen source
YesFree tier

Signal on Tax Engine Software7.6#2 of 28

OpenSalesTax is a self-hosted, open-source service for calculating destination-based US sales tax. Its API handles line items, tax categories, holiday rules, ZIP rates, and jurisdiction-level breakdowns. It uses public Streamlined Sales Tax and state revenue data, with modules covering 52 jurisdictions. Docker or source deployment is free, but you manage hosting, databases, and updates.

Review

In a line

For US transactions, OpenSalesTax provides an open-source engine that works out sales tax. It runs as a web or self-hosted API on Linux or macOS.

What it does

For each line item, the API can calculate tax and report separate amounts for state, county, city, or district jurisdictions. Documented categories include general goods, clothing, groceries, prescription drugs, prepared food, and digital goods, each subject to state-specific taxability rules.

It also includes holiday-aware calculations, such as a Texas clothing exemption example. Version 1 routes cover health checks, jurisdiction coverage, ZIP-based rates, and POST tax calculations.

How it connects

OpenSalesTax is released under the Apache License 2.0 and exposes an HTTP API with Swagger UI, ReDoc, and an OpenAPI specification. Requests are available without credentials but are limited per IP; enabling API keys adds limits and usage records for each key.

You can install it from source with Python 3.11 or newer and PostgreSQL, or run Docker Compose. MariaDB is optional, though release dumps use PostgreSQL COPY format. WooCommerce, Magento 2, Saleor, and Medusa connectors are available, along with PHP and Python clients.

The project relies on Streamlined Sales Tax files and publications from state Departments of Revenue, not commercial tax-data feeds. Each release dump is tied to the SST quarterly file available then, and documented steps let you retrieve and load more recent source data.

Good fit

This suits teams that need US destination-based tax calculations and can operate their own service. The prebuilt compressed PostgreSQL dump is about 47 MiB and is intended to make a fresh setup usable in under two minutes.

It can support ecommerce checkouts through the listed connectors, or direct API use where jurisdiction-level tax lines need to be reconciled.

Watch for

The project does not fully stack sub-state taxes for Colorado home-rule cities or Louisiana parish-level collectors. Earlier release dumps, before v0.59.0, omitted 23 taxing states and need the corrected asset.

Docker restore needs the psql client, which is missing from the runtime image unless you add it or use the source-install route. PostgreSQL is the default database, and you are responsible for hosting, maintenance, and refreshing data.

OpenSalesTax remains pre-1.0, and its public registry currently lists no self-hosters or integrators. The project also says its calculations are not legal or tax advice and advises checking them with the relevant state revenue department.

Pricing

Free / open source: free. This covers Apache 2.0 licensing, self-hosting, and the US sales tax calculation API.

Free self-hosted engine: free. You deploy it with Docker or from source and take care of hosting and maintenance.

Verdict

Choose OpenSalesTax if you want inspectable code, public tax data, and control over where the calculation service runs. It is a practical option for developers operating PostgreSQL-backed infrastructure or one of its ecommerce connectors.

Look elsewhere if you need a managed service, paid tax-data feeds, or complete coverage of the Colorado and Louisiana cases called out by the project. Check the release asset version and database setup before deployment, and treat every result as something to verify with the applicable tax authority.

Our take

OpenSalesTax fits organizations that prefer a free, Apache-licensed tax engine they can host and connect to ecommerce systems. Its API offers useful jurisdiction detail, category rules, holiday handling, and documented endpoints. The tradeoff is operational work: PostgreSQL, deployment, rate updates, and restore tooling are yours to manage. Coverage remains incomplete for Colorado home-rule cities and Louisiana parish collectors, and the project has not reached 1.0. Teams needing a managed product, paid data feeds, or stronger assurances should consider another service. Any calculated amount should be checked with the relevant state revenue department before remittance.

  • Free under the Apache License 2.0
  • Self-hostable with Docker or source deployment
  • Tax results can be separated across state, county, city, and district jurisdictions
  • Supports ecommerce connectors and documented API clients
  • Uses public SST and state revenue data
  • Incomplete sub-state stacking in parts of Colorado and Louisiana
  • Docker runtime lacks the psql client for restores
  • Hosting, maintenance, and data refreshes are your responsibility
  • Project remains pre-1.0 and has no listed users or integrators
  • Older dumps before v0.59.0 omitted 23 taxing states
  • Pick it ifTeams running their own US sales-tax API; Ecommerce systems needing jurisdiction-level tax lines; Users who want open-source, inspectable tax calculations
  • Skip it ifYou need a managed tax service or paid tax-data feeds; Your transactions depend on the listed Colorado or Louisiana gaps; You cannot maintain PostgreSQL hosting and data updates

Pricing

Both listed plans are free. The open-source plan adds Apache 2.0 licensing and self-hosting; the self-hosted engine requires you to handle hosting and maintenance.

  • 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, checked 4 Oct 2026.

Questions

What is OpenSalesTax?

It is an open-source API and engine for destination-based US sales-tax calculations, using public tax data and modules specific to each state.

Which jurisdictions does it cover?

The project has modules for 52 jurisdictions, including 50 states, Washington, D.C., and Puerto Rico. Forty-eight jurisdictions levy sales tax.

Can it show how tax was calculated?

Yes. Responses can separate tax by state, county, city, and district, helping reconcile the total.

What does it cost?

The listed Free / open source and Free self-hosted engine plans both cost free. You remain responsible for hosting and maintenance.

What database does it need?

PostgreSQL is required by default. MariaDB is available through an optional extra, but bundled dumps use PostgreSQL COPY format.

Does it work with ecommerce platforms?

Companion connectors are available for WooCommerce, Magento 2, Saleor, and Medusa, with platform-specific behavior described by the project.

Are the tax results official advice?

No. OpenSalesTax states that its calculations do not constitute legal or tax advice and suggests confirming them with the applicable state Department of Revenue.