Freelance Workspace

Getting Started

Core Level Requests

Geo Level Requests

Response Codes

Account Metrics

Code Samples

Golang

Python

Default

zip.tax API Documentation

zip.tax offers an online look-up service and a developer API for sales tax data. By providing as little as a zip code, we can determine the sales tax rates for your customers in their specific geographical area.

zip.tax Documentation

Production

Sandbox

<p class="slate-p " >zip.tax provides a developer API and an online lookup for sales tax data. Using as little as a postal code, you can find sales tax rates for your customers&apos; specific areas. Sales tax rates often change throughout the year, and our service gives you up-to-date information quickly and easily with no maintenance.</p><p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgba(20, 23, 25, 0.84)">Query by address or postal code, city, and/or state to retrieve all matching results via Core or Geo level plans. The Core plans are best for applications with extensive collection logic or processing rules. Multiple rates are returned and a single rate must be calculated from the application logic. The Core plans are typically used in research, raw data projects, and ERP type systems. The Geo plans are best for applications requiring sales tax rate information for a single location based on a full address search. Geo plans are typically used by point of sale systems, ecommerce, and other customer transaction based solutions.</span></p><p class="slate-p " >Visit <a href="https://zip.tax/pricing" target="_self">https://zip.tax/pricing</a> to sign up.</p><p class="slate-p " >Use the documentation below to learn how to make requests in your code language »</p>

zip.tax provides a developer API and an online lookup for sales tax data. Using as little as a postal code, you can find sales tax rates for your customers' specific areas. Sales tax rates often change throughout the year, and our service gives you up-to-date information quickly and easily with no maintenance.

Query by address or postal code, city, and/or state to retrieve all matching results via Core or Geo level plans. The Core plans are best for applications with extensive collection logic or processing rules. Multiple rates are returned and a single rate must be calculated from the application logic. The Core plans are typically used in research, raw data projects, and ERP type systems. The Geo plans are best for applications requiring sales tax rate information for a single location based on a full address search. Geo plans are typically used by point of sale systems, ecommerce, and other customer transaction based solutions.

Use the documentation below to learn how to make requests in your code language »

<p class="slate-p " >The Core level requests are zip, city, and state level requests and may return multiple rates in the response. Any subscription plan can use the Core level fields. </p><p class="slate-p " ></p>

The Core level requests are zip, city, and state level requests and may return multiple rates in the response. Any subscription plan can use the Core level fields. 

Content-Type

Action

The version of the API response (e.g. v10, v20, v30, v40, v50). Note this will not change over time.

Version

Your API key received at sign-up. Visit https://zip.tax/pricing to obtain a key.

A sample of an address requests to the API

postalcode

Optionally add the City name to attempt to refine the result set.

city

Optionally add the State note to attempt to refine the result. 

state

format

version

rCode

results

addressDetail

<p class="slate-p " >The Geo level requests are address level requests and return a single result in the response. You must have a Geo subscription plan to use the ‘address’ parameter. </p><p class="slate-p " ></p>

The Geo level requests are address level requests and return a single result in the response. You must have a Geo subscription plan to use the ‘address’ parameter. 

address

When 'address' is not used a lat/lng combination can be optionally supplied to determine the closest match address. 

Set to 'auto' to automatically remove city rates for unincorporated areas. 

adjustment

<p class="slate-p " ></p><div class="table-container" style="width:60%;
  min-width:60%;"><table class="slate-table" style="min-width:100%"><div class="published-table-header" style="width:100%;min-width:100%;min-height:initial;visibility: hidden;border:initial"><div style="width:140px;">Title</div><div style="width:0px;">Description</div></div><colgroup ><col style="width:140px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><strong class="slate-bold">Response Code</strong></p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " ><strong class="slate-bold">Definition</strong></p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >100</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Successful API request.</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >101</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The key format was invalid or we did not find your key in the database. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >102</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The format of the State parameter was not in a syntax we could recognize. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >103</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The format of the City parameter was not in a syntax we could recognize. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >104</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The format of the Postal Code parameter was not in a syntax we could recognize. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >105</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The format of the query string did not follow the API spec. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >106</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >General API error. Contact support for details. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >107</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The requestion feature, action, or version was not recognized. See the Base URL spec. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >108</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Your API request limit was met. Contact support to adjust your account. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >109</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The Address paramter could not be parsed. Check to be sure a proper address was provided. </p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >110</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >The request was formatted correctly but produced no results. Please be sure your paramter set contains a valid Postal Code or Address. </p></td></div></tr></tbody></table></div><p class="slate-p " ></p>

Title

Description

account

Static route for the Metrics function in Account info.

metrics

Your API key. Note metrics requests do not count against your API usage. 

Total number of requests in the current month counting toward your Core usage. 

core_request_count

Total monthly request limit for Core usage.

core_request_limit

Percentage consumed from your plan for Core usage. 

core_usage_percent

True if your account is enabled for Geo request features. 

geo_enabled

Total number of requests in the current month counting toward your Geo usage. 

geo_request_count

Total monthly request limit for Geo usage.

geo_request_limit

Percentage consumed from your plan for Geo usage. 

geo_usage_percent

is_active

message

<p class="slate-p " ><p class="slate-p " >Use the code sample guides below to learn how to integrate the <a href="zip.tax" target="_self">zip.tax</a> API into your application&apos;s native code language. </p><p class="slate-p " >To request additional code sample langauges, please send us a message at <a href="mailto:support@zip.tax" target="">support@zip.tax</a></p></p>

Sections