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
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. |