home home Find taxes & rates home Retail sales tax  home Destination-Based Sales Tax home WA Sales Tax Rate Lookup URL Interface WA Sales Tax Rate Lookup URL Interface

 

The URL Interface provides a direct access to the Washington Department of Revenue’s address based rate lookup technology platform.  Using the URL interface we provide, you can access sales and use tax rate data using address or ZIP + 4 code information and tie the data into your shopping cart checkout process or accounting system in real time.  The following information is the technical specifications to access the URL interface. 

 

1.  The rate lookup URL is designed to return the current sales tax rates for an address.  It is designed for use by XMLHttpRequest, Msxml2.XMLHTTP, libcurl, wget, HttpRequest, or similar HTTP protocol client.  Requests can be made for ether XML or plain text responses.

2.  The URL is formated as follows.
http://<servername>/AddressRates.aspx?output=<format>&addr=<address>&city=<city>&zip=<zip>
Where
<servername>    ==> Host name where the service is  running.
<format>        ==> Either "xml" or  "text".
<address>       ==> The street address.
<city>          ==> The city name
<zip>           ==> The 5 or 9 digit ZIP code.

Examples
http://dor.wa.gov/AddressRates.aspx?output=xml&addr=6500  Linderson way&city=&zip=98501 
http://dor.wa.gov/AddressRates.aspx?output=text&addr=6500  Linderson way&city=&zip=985011001
http://dor.wa.gov/AddressRates.aspx?output=xml&addr=6500  Linderson way&city=&zip=98501-1001
3.  HTTP Status Codes

The service will normally return a HTTP status code of 200 OK.  On internal error, it will return a 500 internal server error.

4.  Result Codes

A result code will be returned for both XML and text response formats.  The codes are defined as:

  0:  The address was found. 
  1:  The address was not found, but the ZIP+4 was  located. 
  2:  Neither the address or ZIP+4 was found, but  the 5-digit ZIP was located.
  3:  The address, ZIP+4, and ZIP could not be  found. 
  4:  Invalid arguements. 
  5:  Internal error.
5.  Plain Text Response Format

If the format requested is "text", a simple text string will be returned with the following format.

LocationCode=<location  code> Rate=<rate> ResultCode=<result code> 

Where <location code> ==> The four digit DOR location code. <rate>          ==> The total state and local tax rate. <result code>   ==> The result code described above. Example

LocationCode=3406 Rate=0.084 ResultCode=0
6.  XML Response Format

Example <?xml version="1.0" encoding="UTF-8" ?> <response      loccode="3406"      localrate="0.019"      rate="0.084"      code="0" >       <addressline            houselow="0"            househigh="0"            evenodd="O"            street=""            state="WA"            zip="98501"            plus4="0000"            period="Q22008"            code="3406"            rta="N"            ptba="Thurston PTBA"            cez=""      />      <rate            name="TUMWATER"            code="3406"            staterate="0.065"            localrate="0.019"      /> </response> Tags response   ==> The response package. addressline==> The standardized address and attributes located. If "short cut evaluation" is enabled on the server, the address attributes may be blank or zero. rate       ==> The tax rate information. <response> Attributes loccode    ==> The four digit DOR location code. localrate  ==> The local tax rate. rate       ==> The combined local and state tax rate. code       ==> The result code as defined above. debughint  ==> If the code is invalid argument, this attribute may contain information about the cause of the problem (like invalid ZIP). <addressline> Attributes houselow   ==> Standardized address low house number. househigh  ==> Standardized address high house number. evenodd    ==> 'O' or 'E' street     ==> Standardized address street. state      ==> "WA" zip        ==> Standardized address ZIP. plus4      ==> Standardized address ZIP plus four. period     ==> Tax period in Q[1-4]YYYY format. code       ==> The four digit DOR location code. rta        ==> 'Y' or 'N' ptba       ==> Public transportation benefit area name. cez        ==> Community empowerment zone name. <rate> Attributes name       ==> DOR location code name. code       ==> The four digit DOR location code. staterate  ==> The state portion of the sales tax rate. localrate  ==> The local portion of the sales tax rate.

7.  C# Example Call

      WebClient wc = new WebClient();

      string urlPrefix = protocol +
                  "://" + server + ":" +
                  port.ToString() +
                  "/AddressRates.aspx?format=xml";

      string uri = urlPrefix +
                  "&addr=" +
                  UrlEncode(street) +
                  "&city=" +
                  UrlEncode(city) +
                  "&zip=" +
                  zip.ToString();

      StreamReader reader = new StreamReader(wc.OpenRead(uri));
      string xml = reader.ReadToEnd();
      reader.Close();

      // Now parse the XML
      // ...