ZipTax
Zip-Tax.com provides a very simple API for querying sales and use tax rates in most zip codes in the United States. This gem provides a thin wrapper around the API to quickly and easily retrieve sales tax rates by zip code.
Official documentation for the API is hosted by Zip-Tax.
You will need an API key to get started (sadly, no free developer accounts exist)
Installation
Add this line to your application's Gemfile:
gem 'ziptax', require: 'zip_tax'
And then execute:
$ bundle
Or install it yourself as:
$ gem install ziptax
Usage
Try it out in irb:
gem install ziptax
irb -r ziptaxZipTax::SalesTax.request_for(key: '<yourkeyhere>', postalcode: '10003')
# => {
"version": "v20",
"rCode": 100,
"results": [
{
"geoPostalCode": "10003",
"geoCity": "NEW YORK CITY",
"geoCounty": "NEW YORK",
"geoState": "NY",
"taxSales": 0.088749997317791,
"taxUse": 0.088749997317791,
"txbService": "L",
"txbFreight": "Y",
"stateSalesTax": 0.03999999910593,
"stateUseTax": 0.03999999910593,
"citySalesTax": 0.045000001788139,
"cityUseTax": 0.045000001788139,
"cityTaxCode": "NE 8081",
"countySalesTax": 0,
"countyUseTax": 0,
"countyTaxCode": "",
"districtSalesTax": 0.003749999916181,
"districtUseTax": 0.003749999916181
},
{
"geoPostalCode": "10003",
"geoCity": "NEW YORK",
"geoCounty": "NEW YORK",
"geoState": "NY",
"taxSales": 0.088749997317791,
"taxUse": 0.088749997317791,
"txbService": "L",
"txbFreight": "Y",
"stateSalesTax": 0.03999999910593,
"stateUseTax": 0.03999999910593,
"citySalesTax": 0.045000001788139,
"cityUseTax": 0.045000001788139,
"cityTaxCode": "NE 8081",
"countySalesTax": 0,
"countyUseTax": 0,
"countyTaxCode": "",
"districtSalesTax": 0.003749999916181,
"districtUseTax": 0.003749999916181
}
]
}Contributing
- Fork it ( https://github.com/brycemcd/ziptax/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request