The Zip-Tax.com API is designed to allow programmers to submit a request to our servers from a website or application and retrieve response data from our databases. The format of the response can be returned as JSON or XML. Simply pass the desired format as part of the request.

API URL

The Zip-Tax.com URL consists of three parts which form the basic url for the api request.

http://api.zip-tax.com/request/v20
Sub Domain:api.zip-tax.com
Action:/request
Version:/v20 Optionally use v10 for a summary data set.
Sample - full formatted URL

The Zip-Tax.com API URL consists of the following GET Request parameters which are used to generate the result.

http://api.zip-tax.com/request/v20?key=1234567890&postalcode=90265&state=CA&format=JSON
keyrequiredYour account key
postalcoderequiredThe 5 digit postal code. NOTE: Include leading zeros
stateoptionalThe 2 letter state code. Example: CA for California
cityoptionalThe full city name
formatoptionalThe return format. Valid formats are JSON or XML. The default format is JSON
Response

The Zip-Tax.com API will return the following response values

versionThe API version string [ v10 or v20 ]
rCode (JSON) or code (XML)The request reponse code
message (XML only)Special service messages [deprecated]
results (JSON) or response (XML)The API result array
Response Codes - [ rCode (JSON) or code (XML) ]

This list represents the response codes returned by the API

100SUCCESSSuccessful API request
101INVALID_KEYKey format is not valid
102INVALID_STATEState format is not valid
103INVALID_CITYCity format is not valid
104INVALID_POSTAL_CODEPostal code format is not valid
105INVALID_FORMATQuery string format is not valid
Results - [ results (JSON) or response (XML) ]

This list represents the results array values returned by the API

geoPostalCodeRequested postal codeall versions
geoCityCityall versions
geoCountyCountyall versions
geoStateStateall versions
taxSalesTotal sales taxall versions
taxUseTotal use taxall versions
txbServiceTaxable service (values: null,Y,N,L)all versions
txbFreightTaxable freight (values: null,Y,N)all versions
stateSalesTaxPortion of total sales tax from the state levelv20 only
stateUseTaxPortion of total use tax from the state levelv20 only
citySalesTaxPortion of total sales tax from the city levelv20 only
cityUseTaxPortion of total use tax from the city levelv20 only
cityTaxCodeApplicable city tax codev20 only
countySalesTaxPortion of total sales tax from the county levelv20 only
countyUseTaxPortion of total use tax from the county levelv20 only
countyTaxCodeApplicable county tax codev20 only
districtSalesTaxPortion of total sales tax from the district levelv20 only
districtUseTaxPortion of total use tax from the district levelv20 only
Sample JSON Response
Sample XML Response

Our Partners

Amazon AWS Apple Symfony Ubuntu PayPal