Go SDK

Official Go SDK for the Ziptax API

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.

The Go SDK is currently offered as a Beta product. Please send your comments and suggestions to support@zip.tax.

Project resources

GitHub Repository

Go Package

Implementation example

Install

$ go get github.com/ziptax/ziptax-go

Import

1 import (
2     "context"
3     "fmt"
4     "log"
5     "os"
6     "time"
7 
8     "github.com/ziptax/ziptax-go"
9 )

Configure the client

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

Get sales tax by address

1 ctx := context.Background()
2 response, err := client.GetSalesTaxByAddress(
3     ctx,
4     "200 Spectrum Center Drive, Irvine, CA 92618",
5 )
6 if err != nil {
7     log.Fatal(err)
8 }

Print the result

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

Full documentation

Full reference documentation, including all request options, response types, and helper functions, is available in the GitHub repository and the Go Package documentation.

1	import (
2	"context"
3	"fmt"
4	"log"
5	"os"
6	"time"
7
8	"github.com/ziptax/ziptax-go"
9	)

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

1	ctx := context.Background()
2	response, err := client.GetSalesTaxByAddress(
3	ctx,
4	"200 Spectrum Center Drive, Irvine, CA 92618",
5	)
6	if err != nil {
7	log.Fatal(err)
8	}

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