Avalara Developer Network Developer avaTax

Get Started

Four simple steps to getting started in calculating sales tax with our REST API

If you already have an Avalara AvaTax account and want to dive into the details, a good place to start is our Introduction to the Avalara AvaTax API.

1 Try the API

Want to know how the API looks? Make some requests to either Calculate Tax or Validate an Address. See how different inputs produce different tax calcluation results, and see what kind of tax information you can expect to get back.

2 Create an AvaTax Account

To get started, we’ll first set you up with an AvaTax account. This account will allow you to get started right away using our production environment, including access to the full AvaTax Pro System Tax Code functionality and Global Nexus Jurisdictions.

This account is initially active for 60 days, but you can request an extension if needed. You will need to add company profile and tax profile information to calculate sales tax. If you decide to purchase a subscription at a later date, it can be added directly to this account so that no data migration is required.

Use this form to request a free trial account today:

3 Visit the AvaTax Website

To calculate tax correctly, we'll need to know a few things about your company. Fortunately, the AvaTax Website provides a streamlined onboarding process that helps you configure your company quickly and easily. Visit AvaTax Website for Sandbox Accounts and walk through the five minute setup process.

4 Calculate Tax

Your next step is to calculate tax online using the interactive AvaTax API reference page. If you want to sell $100 worth of Yarn at a retail location in Irvine, California, here's what your transaction would look like:
  "type": "SalesInvoice",
  "date": "2017-03-06",
  "customerCode": "ABC",
  "addresses": {
    "singleLocation": {
      "line1": "123 Main Street",
      "city": "Irvine",
      "region": "CA",
      "country": "US",
      "postalCode": "92615"
  "lines": [
      "number": "1",
      "quantity": 1,
      "amount": 100,
      "description": "Yarn"

You can copy and paste this text into the `model` parameter box on the CreateTransaction API call, then click `Try it out!`. If you get an `Authorization Incomplete` error, click the `Authorize` button on the top right hand corner of the page and fill out your credentials, then try creating the transaction again.

Mixed in along with all the diagnostic information, you'll see this data in the result:

  "id": 279797011,
  "code": "7a6e9396-e152-4bb2-821c-6d746c3641be",
  "companyId": 238146,
  "date": "2017-03-06",
  "totalAmount": 100,
  "totalExempt": 0,
  "totalTax": 7.75,
  "totalTaxable": 100,
  "totalTaxCalculated": 7.75,

This means you should charge your customer $7.75 worth of tax for this sale!

Optional Step:

Download an AvaTax SDK

Avalara has a wide variety of available software development kits for major languages. If you are writing your own code in a supported language, the AvaTax software development kit will help you get up to speed quickly!

The AvaTax SDK contains a lot of useful features to make it quick and easy to begin using all of the world-class features built into AvaTax. Even better, all of our SDKs are fully open source and we welcome bug reports and pull requests to add new features!

What's Next?

We're really proud of the world-leading AvaTax platform, and we hope you'll have as much fun using it as we have fun building it! Here are some ideas for next steps:

  • Read our Developer Blog for up-to-date news and articles about the great features of AvaTax
  • Ready to upgrade to a production account? Please contact the sales department anytime and we'll be happy to help you out.
  • Want to develop a certified connector? Visit our Certified Avalara Integration page today and get started!
  • Want more information about all the great API features in AvaTax? Visit the online AvaTax API reference now!
  • Have a question about the API, or want to share your success story? Visit the AvaTax Developer Community and ask questions and share tips and tricks with other developers from around the world!