> This page is for version v6.0 (default).
> For other versions, use one of these documentation indexes:
> - v6.0 (default): https://docs.zip.tax/v-6-0/llms.txt
> - v5.0: https://docs.zip.tax/v-5-0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.zip.tax/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.zip.tax/_mcp/server.

# Python SDK

The Python SDK offers a simple, intuitive interface for interacting with the
Ziptax API from scripts, data pipelines, and applications. It supports both
synchronous and asynchronous usage, includes built-in error handling, and
integrates naturally with common Python workflows for data engineering, ETL,
and backend services. This SDK is a great fit for teams working in Databricks,
AWS Lambda, FastAPI, Django, or other Python-driven environments.

> **Info**
>
> The Python SDK is currently offered as a **Beta** product. Please send your
> comments and suggestions to [support@zip.tax](mailto:support@zip.tax).

## Project resources

#### [GitHub Repository](https://github.com/ZipTax/ziptax-python)

#### [PyPI Package](https://pypi.org/project/ziptax-sdk/)

## Implementation example

### Install

```bash
pip install ziptax-sdk
```

### Import

```python
from ziptax import ZiptaxClient
```

### Configure the client

```python
client = ZiptaxClient.api_key(
    "your-api-key-here",
    timeout=60,       # Request timeout in seconds
    max_retries=5,    # Maximum retry attempts
    retry_delay=2.0,  # Base delay between retries
)
```

### Get sales tax by address

```python
response = client.request.GetSalesTaxByAddress(
    "200 Spectrum Center Drive, Irvine, CA 92618"
)
```

### Print the result

```python
print(f"Address: {response.address_detail.normalized_address}")
if response.tax_summaries:
    for summary in response.tax_summaries:
        print(f"{summary.summary_name}: {summary.rate * 100:.2f}%")

# Always close the client when done
client.close()
```

## Full documentation

Full reference documentation, including async usage, all request options,
response types, and helper functions, is available in the
[GitHub repository](https://github.com/ZipTax/ziptax-python) and on
[PyPI](https://pypi.org/project/ziptax-sdk/).