Article

How Does Avalara Address Validation Work

Last updated · Nov 18, 2026
Piyush Agrawal

Piyush Agrawal

Co-founder at Galvix

How_does_Avalara_address_validation_work

Read this article on your favorite platform

On this page
  1. Quick answer
  2. Why address validation matters for tax calculation
  3. How the ResolveAddressPost API validates addresses
  4. Where to validate addresses in AvaTax
  5. Supported address types and their use in validation
  6. Using latitude and longitude for address validation
  7. Geographic coverage and limitations
  8. Common address validation issues and fixes
  9. Expert tip: Disable address validation outside the US and Canada
  10. How Galvix can help with sales tax accuracy and filing
  11. FAQ

Avalara's address validation service validates shipping and billing addresses to improve tax calculation accuracy. The service uses the ResolveAddressPost API to validate US and Canadian addresses, returning corrected formatting and resolution quality indicators for determining correct tax jurisdictions.

Quick answer

  • Avalara validates addresses through the ResolveAddressPost API, which validates US and Canadian addresses and returns a resolution quality indicator
  • The service validates addresses you enter for company locations, customer records, and transaction lines to ensure AvaTax assigns the correct tax jurisdictions based on precise address data
  • Address validation does not provide autocomplete or suggestions; it only validates complete addresses you submit, and you pay per 10 validations
  • A validated address produces the most accurate tax result; an unvalidated address will likely still calculate tax but may be less accurate

Why address validation matters for tax calculation

Valid addresses are critical to accurate sales tax calculation. You cannot rely on ZIP codes alone because USPS sets ZIP code zones for mail delivery, while tax authorities define tax jurisdictions using different boundaries. Special tax districts for stadiums, restaurants, or transit often cross ZIP code lines.

ZIP codes also cannot correctly handle transactions in states using mixed sourcing rules, such as California and Texas. In these states, the origin address allocates part of the tax and the destination address allocates the other part. Without precise address data, AvaTax cannot determine the correct apportionment between origin and destination jurisdictions.

How the ResolveAddressPost API validates addresses

When you call the ResolveAddressPost API, you submit address fields including line1, city, region, country, and postalCode. The API validates the address and returns a validated address with a ResolutionQuality indicator.

Resolution Quality Meaning Recommended Action
External AvaTax cannot identify the address Warn the user and ask them to verify the address
NotCoded The address is not recognized in Avalara's system Warn the user and ask them to verify the address
Other values The address validated successfully Use the validated address for the transaction

If the ResolutionQuality is External or NotCoded, return a warning to your user and ask them to verify the address. If the user accepts an address that did not validate, you can specify line1 = "GENERAL DELIVERY" as a fallback. This is a special code recognized by USPS that allows nonrecognized addresses to be processed. AvaTax will return tax based on the postal code rather than the exact address.

Where to validate addresses in AvaTax

You can validate addresses in several places within AvaTax:

  • Company locations: Validate the origin addresses for your warehouses, stores, or service locations
  • Customer addresses: Validate shipping and billing addresses in customer records
  • Order entries: Validate addresses when you create transactions at the document level or line level

Supported address types and their use in validation

Address Type Use Required for Validation
singleLocation Retail point-of-sale where origin and destination are the same City, region, postal code (best practice: include full address)
shipFrom Origination address where products shipped from or services originated City, region, postal code (best practice: include full address)
shipTo Destination address where products shipped to or services delivered City, region, postal code (best practice: include full address)
pointOfOrderAcceptance Location where order was accepted (for purchase documents) City, region, postal code (best practice: include full address)
pointOfOrderOrigin Location where customer placed the order (for sales documents) City, region, postal code (best practice: include full address)

While only city, state, and postal code are required for calculation, provide as much address information as you have available. This ensures the most accurate tax calculation possible.

You can specify addresses at the document level or the line level. Document-level addresses apply to the entire transaction as a default. Line-level addresses represent individual shipments and override document-level addresses for specific lines.

Using latitude and longitude for address validation

AvaTax supports specifying latitude and longitude when you configure any address type. This option is useful for locations that can only be pinpointed by geolocation, such as remote construction sites or outdoor service areas.

If you provide latitude and longitude along with line, city, region, country, and postal code, AvaTax uses only the latitude and longitude and discards the other address fields for the transaction. Latitude and longitude are available only for US addresses.

Geographic coverage and limitations

Avalara's address validation service is available only for US and Canadian addresses. If you use this service, disable address validation in your user interface when a user inputs an address outside the US or Canada.

The service does not currently provide autocomplete or suggestions when users input an address. It only validates complete addresses you submit after entry.

Avalara charges per 10 address validations, so consider ways to reduce usage in your integration. For example, validate addresses only when a user completes entry or clicks a validate button, rather than validating on every keystroke.

Common address validation issues and fixes

Missing directional or street type information: The address may be missing directional information such as NW or SE, or street type such as Blvd or Rd. Verify the address online using a map or search engine.

Address not registered with USPS or Canada Post: The address may not be registered yet, especially for new construction. If the address is real but not in the postal system, you can use General Delivery as a temporary workaround.

Format does not match postal standards: The format doesn't match postal standards.

Using General Delivery for unregistered addresses: If an address fails validation but you know it is correct, enter General Delivery in Line 2 of the address (or at the end of Line 1 if there is only one address line). Include the correct city, state or province, and ZIP or postal code. AvaTax will return tax based on the postal code rather than the exact address.

Expert tip: Disable address validation outside the US and Canada

If your users enter addresses in countries other than the US or Canada, disable address validation in your interface for those transactions. Avalara's address validation service only supports US and Canadian addresses, so attempting to validate other addresses will fail unnecessarily.

How Galvix can help with sales tax accuracy and filing

Avalara validates addresses to identify the correct tax jurisdictions, but accurate addresses are only one part of sales tax compliance. Your finance team still needs to ensure that transaction data, tax amounts, and jurisdiction details are correct before preparing and filing returns.

If your team is spending too much time investigating tax discrepancies, reconciling transactions, and managing filing deadlines, Galvix can take that ongoing compliance work off their plate. Our team works with data from your billing and accounting systems, reconciles sales and tax amounts, prepares sales tax returns, and files them after your approval. You can track everything through a dashboard without managing the filing process yourself.

Book a demo to see how Galvix can help manage your sales tax compliance.

FAQ

Does address validation work for addresses outside the US and Canada?

No. Avalara's address validation service supports only US and Canadian addresses. If your users enter addresses in other countries, disable address validation in your interface for those transactions.

What happens if I submit a transaction with an unvalidated address?

AvaTax will still calculate tax for the transaction, but the result may be less accurate. An unvalidated address can cause AvaTax to assign the wrong tax jurisdiction if the address is ambiguous or incorrectly formatted.

Can I validate an address without creating a transaction?

Yes. The ResolveAddressPost API validates addresses independently of transaction creation. You can call this API whenever a user enters an address in your system, then store the validated address for use in future transactions.

How much does address validation cost?

Avalara charges per 10 address validations. The exact cost depends on your AvaTax subscription and pricing agreement. Contact Avalara or check your account settings for current pricing.

What should I do if the validated address does not match what the customer entered?

Display both the original address and the validated suggestion to the user. Let them choose which address to use before completing the transaction.

Piyush Agrawal

Piyush Agrawal

Co-founder at Galvix

Piyush Agrawal is the Co-founder of Galvix, a managed service for sales tax compliance. He studied at Stanford University and IIT Kanpur, and has been recognized as a Top Innovator Under 35 by MIT Technology Review.

Connect on LinkedIn

Filed under Software & vendors · Browse all articles

Let Galvix handle sales tax for you

Galvix provides an end-to-end sales tax management service, including nexus monitoring, tax calculations, and return filing, giving you the confidence and time to focus on what matters - your business.

Book a Demo