> 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.

# Go SDK

The Go SDK provides a fast, type-safe client tailored for high-performance
backend services. It includes well-structured request/response models,
automatic handling of API keys, convenient helpers for tax calculation and
jurisdiction lookup, and native support for `context.Context`. It's ideal for
microservices, concurrent processing pipelines, and any environment where
efficiency and reliability are primary concerns.

> **Info**
>
> The Go 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-go)

#### [Go Package](https://pkg.go.dev/github.com/ziptax/ziptax-go)

## Implementation example

### Install

```bash
go get github.com/ziptax/ziptax-go
```

### Import

```go
import (
    "context"
    "fmt"
    "log"
    "os"
    "time"

    "github.com/ziptax/ziptax-go"
)
```

### Configure the client

```go
client, err := ziptax.NewClient(
    "your-api-key",
    ziptax.WithTimeout(60*time.Second),
    ziptax.WithMaxRetries(5),
    ziptax.WithRetryWait(2*time.Second, 60*time.Second),
)
```

### Get sales tax by address

```go
ctx := context.Background()
response, err := client.GetSalesTaxByAddress(
    ctx,
    "200 Spectrum Center Drive, Irvine, CA 92618",
)
if err != nil {
    log.Fatal(err)
}
```

### Print the result

```go
fmt.Printf("Address: %s\n", response.AddressDetail.NormalizedAddress)
if len(response.TaxSummaries) > 0 {
    fmt.Printf("Total Tax Rate: %.4f%%\n", response.TaxSummaries[0].Rate*100)
}
```

## Full documentation

Full reference documentation, including all request options, response types,
and helper functions, is available in the
[GitHub repository](https://github.com/ZipTax/ziptax-go) and the
[Go Package documentation](https://pkg.go.dev/github.com/ziptax/ziptax-go).