---
id: taxjar
version: "2.0.1"
license: unclear
license_treatment: permissive
maintenance: aging
---

# taxjar — Sales tax API client for Python

License: permissive · Maintenance: aging · Downloads: 133.5K/mo

## What it is and what it does

TaxJar is an official Python wrapper around the TaxJar Sales Tax API Version 2. It maps API responses to Python objects and provides methods for calculating sales tax on orders, managing transaction records (orders and refunds), handling customer data, validating addresses, and retrieving tax rates by jurisdiction. The package depends on requests for HTTP communication and jsonobject for mapping JSON responses to Python objects.

You instantiate a client with your TaxJar API key and call methods like tax_for_order() to compute tax liability, list_orders() to retrieve past transactions, or rates_for_location() to look up tax rates by postal code. The library handles authentication and request formatting automatically, returning structured Python objects rather than raw JSON.

Use it for:

- Calculate sales tax due on an e-commerce order given origin and destination addresses and line items
- Retrieve and manage order and refund transaction records stored in TaxJar for compliance reporting
- Look up applicable tax rates for a given location to display at checkout or in tax estimation tools
- Validate customer addresses and VAT numbers before processing transactions
- Sync customer and transaction data with TaxJar for centralized tax compliance tracking

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for the TaxJar Sales Tax API, providing methods to calculate sales tax, manage orders and refunds, validate addresses, and retrieve tax rates and categories.

Yes, if you need to integrate with TaxJar's API and accept its aging maintenance status. The package is stable (Production/Stable classifier), has no known vulnerabilities, and low install friction. However, the last commit was 487 days ago—verify that it still works reliably with current TaxJar API endpoints before relying on it in production. If active maintenance is a priority, check whether TaxJar or the community have released a more recent fork.

## Install

pip install taxjar
uv add taxjar
poetry add taxjar

## Installing taxjar

Before you install: Low install friction with only two runtime dependencies (requests and jsonobject). Maintenance status is aging—last commit was 487 days ago, though the repository remains active and unarchived.

License in practice: Licensed under MIT (permissive), meaning you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart:

pip install taxjar

import taxjar
client = taxjar.Client(api_key='your_api_key')
tax = client.tax_for_order({
  'from_country': 'US',
  'from_zip': '94025',
  'to_country': 'US',
  'to_zip': '94303',
  'amount': 267.9
})

Requires a TaxJar API key obtained from https://app.taxjar.com/api_sign_up/plus/

Verify before relying:

- Whether the package still works reliably with current TaxJar API endpoints given the aging maintenance status
- Current Python version support—classifiers list Python 2.6 and 2.7, but requires_python is unspecified

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 133.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sales tax calculation api, taxjar python client, sales tax compliance, tax rate lookup, order tax computation, tax jurisdiction validation, sales tax api wrapper, tax-compliance, api-client, ecommerce

[View on SkillFed](https://skillfed.io/packages/taxjar) · [View on PyPI](https://pypi.org/project/taxjar/)