TaxJar API Reference

The TaxJar API provides two endpoints for developers.
By using the API, you accept the terms of the TaxJar user agreement.

We’ve tried to make this simple but let us know if you have any feedback. Email us.

Authorization

In order to use these API, an API Token is required to be passed in the request header.

Get your API Token by signing up

Smart Sales Tax API

The TaxJar Smart Sales Tax API takes the state from which you ship (or the state in which you have nexus,) amount, shipping charged, city and zip-code from which you ship (or from the state in which you have nexus,) city and zip-code shipped-to as input and returns the amount of sales tax that should be withheld. It determines the rate based on city and zip-code (including plus 4 information), taking into account whether or not the state in question is origin-based or destination based and whether or not shipping is taxable.

Endpoint

http://api.taxjar.com/locations/sales_tax

Example

Try it

Request

curl 'http://api.taxjar.com/sales_tax?state=NJ&amount=10&shipping=2&from_city=Ramsey&from_zip=07446&to_city=Freehold&to_zip=07728' -H 'Authorization: Token token="dae79dc5154ccabd7cb169f616d605e7"'

Response

{"amount_to_collect":0.84}

Parameters

State Two letter postal abbreviation for state where the order is shipped from and to.
Amount Amount of the order, excluding shipping.
Shipping Amount charged for shipping.
From City City order was shipped from or when business has nexus.
From Zip Zip code order was shipped from or when business has nexus.
To City City order was shipped to.
To Zip Zip code order was shipped to.

Error responses

HTTP statusCause
401Not authorized. Access token is missing or invalid.
404Not found. Five digit zip not recognized.
500Internal Server Error. Please contact support@taxjar.com

Tax Rate Lookup

The TaxJar Sales Tax Rate API takes location as input and returns the Sales Tax rates for the location. Minimum required is five digit zip. If zip includes plus4 and city is provided, the response will be more accurate. In order to use the API, an API Token is required to be passed in the request header.

Endpoint

http://api.taxjar.com/locations/<zip code>/<city name>

Example

Try it

Request

curl 'http://api.taxjar.com/locations/07446/ramsey' -H 'Authorization: Token token="dae79dc5154ccabd7cb169f616d605e7"'

Response

{
				  "location":{
				    "state":"NJ",
				    "zip":"07446",
				    "state_rate":"0.07",
				    "city":"RAMSEY",
				    "city_rate":"0.0",
				    "county":"BERGEN",
				    "county_rate":"0.0",
				    "combined_district_rate":"0.0",
				    "combined_rate":"0.07"
				  }
				}

What are combined rates?

Combined District Rate Aggregate Rate for all city and county sales tax districts effective at the location. A complete breakdown of these districts is available as well. Please contact support@taxjar.com for more information.
Combined Rate Overall Sale Tax rate which includes the State, County, City and District portions. This is the rate that should be used to determine how much Sales Tax to collect for an order.

Error responses

HTTP statusCause
401Not authorized. Access token is missing or invalid.
404Not found. Five digit zip not recognized.
500Internal Server Error. Please contact support@taxjar.com