By Lat / Lng

Adding your API key in the header is an optional way to pass your API key. You can also use the key query parameter to pass your key.

Using the correct content type ensures that clients and servers correctly interpret the data being exchanged as JSON, allowing for proper parsing and handling. The default encoding for JSON is UTF-8.

Using the key query parameter is an optional method for passing your API key. The recommended method is to use the X-API-KEY header value noted above.

The latitude value for the requested location. You can view the normalized address used for the rate query published in the response data. NOTE: precision to 5 decimal places is recommended for the most accurate result.

The longitude value for the requested location. You can view the normalized address used for the rate query published in the response data. NOTE: precision to 5 decimal places is recommended for the most accurate result.

Format options include json or xml. JSON is the default response format. Be sure to update your Content-Type header if you choose to use the xml formatted response.

Optionally provide a valid ISO 3166-1 alpha-3 country code for rates outside the US. This feature is only available to Pro and Enterprise Plan levels. By default the request will use the USA country code.

The taxabilityCode is an optional value used for sending product taxability codes to get product tax rules in the response. This feature is only available for Pro and Enterprise level plans.

Provides the API version which determines the feature set available and the response syntax.

The metadata object includes information relevant to the response state.

The baseRates object includes the full tax rate itemization for the state, county, city, and district level rates. The rates are combined in the taxSummaries object to provide a full combined rate.

The service object contains details about the taxability of service specific items when stated separately on an invoice.

The shipping object contains details about the taxability of shipping and handling specific items when stated separately on an invoice.

The sourcingRules object provides details related to the origin / destination taxability. This object is used in combination with your business' nexus rules to calculate the sales tax relevant to the appropriate location of the shipping or sale.

The taxSummaries object includes the total combined Sales or Use Tax rate to be applied to the sale/item.

The productDetail object is included when a taxabilityCode item is included in the request. This object outlines the product taxability rules for the provided product code. NOTE: the rates in the response are not adjusted based on the indicated product rules. These rules are provided for your own information and can be used to perform calculation adjustments as needed.

When a request is made, the address used in the input is translated into a normalized address per the local addressing authority (e.g. the USPS for the United States). The addressDetail object contains information about the normalized address used to provide the response data.