Our REST API is quite simple. One API to normalise an address, one API to determine the tax method and rate. The Responses are sent in JSON.

Tax Lookup

123 Fake St. New York, NY 10001, USA

Request

POST /api/tax

address=123%20Fake%20St.%20New%20York%2C%20NY%2010001%2C%20USA

Response

{
    "Address":"Manhattan, NY 10001, USA"
    "Code":"400"
    "General":"-1.000"
    "Message":"Street Address is required for New York"
    "asof":"2011-10-01"

}

30 Market St, San Francisco

{
    "Address":"30 Market St, San Francisco, CA 94105, USA"
    "General":"8.500"
    "asof":"2011-11-11"
    "cite":"http://www.boe.ca.gov/"

}

98107

{
    "Address":"Seattle, WA 98101, USA"
    "City":"3.000"
    "General":"9.500"
    "State":"6.500"
    "asof":"2011-11-11"
    "cite":"http://dor.wa.gov/content/findtaxesandrates/salesandusetaxrates/lookupataxrate/"

}

Address Normalisation

This API provides a method to retrieve the canonical address from the data supplied. Simply post with one field,

POST /api/address

address=123%20Fake%20St.%20New%20York%2C%20NY%2010001%2C%20USA
Array
(
    [address] => 
    [country_iso2] => 
    [country_name] => 
    [region_iso2] => 
    [region_name] => 
    [city_name] => 
    [postal_code] => 
)

30 Market St, San Francisco

Array
(
    [address] => 
    [country_iso2] => 
    [country_name] => 
    [region_iso2] => 
    [region_name] => 
    [city_name] => 
    [postal_code] => 
)

98107

Array
(
    [address] => 
    [country_iso2] => 
    [country_name] => 
    [region_iso2] => 
    [region_name] => 
    [city_name] => 
    [postal_code] => 
)