Introduction

Welcome to the taxigy.com Sales Tax API

By providing as little as a zip code, we can determine the sales tax rates for your customers in their specific geographical area. In most states, sales tax rates change many times throughout the year. Our service provides you with a method to get this information quickly and easily and with no maintenance. The Taxigy team is dedicated to providing you with the critical up-to-date information you need so you can focus on the important parts of your business.

Our Taxigy.com API is designed to allow programmers to submit a request to our servers from a website or application and retrieve response data from our databases. The format of the response can be returned as JSON. Simply pass the desired format as part of the request. Taxigy.com works by submitting geographic information such as city, state, and zip code from your application or website. This data is used determine the correct sales tax information matching the provided location. Our service then returns that information to your application or website.

Getting Started

Request header requirement

curl --header "Accept:application/json"

The Taxigy.com sales tax API uses standard Representational State Transfer (REST) principles for maximum flexibility with a wide range of program languages.

To get started, simply follow this documentation to build a reuqest using the Taxigy.com Request URL, parse the API Response to validate the response codes, and use the API results in your application.

API Subscription Types

General API

The general Taxigy.com sales tax API allows jurisdiction lookups using any combination of zip code, city, and state. This API level does not provide full address level lookup and only provides county data via response.

Request

Base URL

Base URL Example

curl -H "Content-Type: application/json" -X GET https://api.taxigy.com/api/v10

The API request URL is used to form your request to the API from your application.

The base request URL consists of three parts.

Subdomain	Action	Version
api.taxigy.com	/api	/v10

HTTP Request

GET https://api.taxigy.com/api/v10/tax

Get Tax Record By ZipCode

Request Example with Query Params

curl -H "Content-Type: application/json" -X GET https://api.taxigy.com/api/v10/tax?apiKey=xxxxxxxxxxxxxx&zipCode=82053

The General API can be used with all subscription types. The API supports multiple address parameters specified in the table below.

Query Parameters

Parameter	Required	Description
apiKey	Yes	Your API key
zipCode	Yes	U.S. jurisdiction postal code (zip code)

Full Request Example (with query parameters)

This endpoint returns a sample request.

GET https://api.taxigy.com/api/v10/tax/county/state

Get Tax Record By Location

Request Example with Query Params

curl -H "Content-Type: application/json" -X GET https://api.taxigy.com/api/v10/tax/county/state?apiKey=xxxxxxxxx&location=936%20SW%201st%20Ave,%20Miami,%20FL%2033130

The General API can be used with all subscription types. The API supports multiple address parameters specified in the table below.

Query Parameters

Parameter	Required	Description
apiKey	yes	Your API key
location	yes	Your Location String

Full Request Example (with query parameters)

This endpoint returns a sample request.

GET https://api.taxigy.com/api/v10

Response Results

{
  "version": "v10",
  "rCode": 100,
  "results": [
    {
      "ZipCode": 82053,
      "State": "WY",
      "County": "LARAMIE COUNTY",
      "NormalizedCounty": "laramie-county",
      "City": "BURNS",
      "NormalizedCity": "burns",
      "TaxRegionName": "LARAMIE COUNTY",
      "Normalized": "laramie-county",
      "CombinedRate": 6,
      "StateRate": 4,
      "CountyRate": 2,
      "CityRate": 0,
      "SpecialRate": 0,
      "EstimatedPopulation": 1157
      "Year": 2020,
      "Month": 9
    }
  ]
}

Name	Description	Version
ZipCode	Requested postal code	all
State	State	all
County	County	all
NormalizedCounty	County Normalized	all
City	City	all
NormalizedCity	City Normalized	all
TaxRegionName	Name of a tax region	all
Normalized	Normalized	all
CombinedRate	Portion of total tax	all
StateRate	Portion of total tax from the state leve	all
CountyRate	Portion of total tax from the county level	all
CityRate	Portion of total tax from the city level	all
SpecialRate	Portion of total special tax	all
EstimatedPopulation	Estimated	all
Year	Tax Year	all
Month	Tax Mounth	all

Response Codes

The taxigy.com API returns the following response codes based on request results.

Code	Reason	Description
100	SUCCESS	Successful API Requet
101	INVALID_KEY	Key format is not valid
102	INVALID_FORMAT	Query string format is not valid
103	INVALIDZIPCODE	Zip code format is not valid
104	API_ERROR	Api error
105	REQUESTLIMITMET	Api request limit met
106	TOKEN_EXPIRED	Token is expired
107	USERNAMENOT_FOUND	Token is expired

Support

For questions or comments please contact us via email at: support@taxigy.com.