Page tree
Skip to end of metadata
Go to start of metadata



This is the basic operation for finding sales tax rates in the United States. Given a US zip code and a tax type, it returns sales tax information for that zip code. Several pieces of information are returned, starting with basic information about the area. Zip code, city, county, FIPS, and state are returned here. 
Six tax rates are also returned. An overall rate that represents the combined sales tax rate for that area and the five tax rates it is based on. These five rates are the state rate, the city rate, the county rate, the county district rate and the city district rate. Finally, a field representing any tax exemptions that might be available. Exemptions are normally kept at the state level and can consist of any combination of Labor, Freight and Services. By examining the WSDL, you may see that the service can return multiple tax rates (multiple TaxInfo results). This is because at the zip code level, it is possible that there may be additional matches found. Zip codes can border multiple cities and counties and each might have a different tax rate. It is important to consider all of the results since any of them may be the correct one.


URL Endpoints


XML: https://trial.serviceobjects.com//ft/FastTax.asmx/GetTaxInfoByZip_V2?PostalCode=string&TaxType=string&LicenseKey=string


GetTaxInfoByZip_V2 Inputs


Name

Type

Values

Description

PostalCode

String

Varies

The zip code associated with the desired tax rates

TaxType

String

sales / use

Selects the type of tax to look for, for the given area.

LicenseKey

String

Varies

Your license key to use the service. 
Sign up for a free trial key at 
www.serviceobjects.com.


GetTaxInfoByZip_V2 Outputs


Name

Type

Values

Description

Zip

String

Varies

The given zip code

City

String

Varies

The city associated with the given zip code

County

String

Varies

The county associated with the given zip code

CountyFIPS

String

Three digit number

The FIPS code associated with the zip code

StateName

String

Varies

The state associated with the give zip code

StateAbbreviation

String

Two letter state code

The common two letter state abbreviation

TotalTaxRate

String

Decimal digit

The decimal representation of the overall tax rate

TotalTaxExempt

String

Varies

The exemptions available for that area. Combinations of Labor/Freight/Services

StateRate

String

Decimal digit

The decimal representation of the state's tax rate

CityRate

String

Decimal digit

The decimal representation of the city's tax rate

CountyRate

String

Decimal digit

The decimal representation of the county's tax rate

CountyDistrictRate

String

Decimal digit

The decimal representation of any special district tax rates for the county

CityDistrictRate

String

Decimal digit

The decimal representation of any special district tax rates for the city

Error

String

Varies

The error object containing information about the error returned.


References

  • No labels