Address validation candidates

At Smarty, we specialize in address validation. Our goal is to take the input you give us and match it to the best possible address candidate. 

A candidate is what you get back from our system after you submit an address for validation. Candidates will always be valid addresses. As you enter addresses into a form with our autocomplete feature, we're also able to provide address suggestions as you type. 

International autocomplete suggestions are based on the street, city, and region combination, and most suggestions will correspond to valid addresses.

Want to see how your international address data stacks up? Send us a list of addresses, and we can evaluate your data health and compare Smarty’s accuracy against other international providers.

Smarty's US autocomplete suggestions will always be a valid address. Suggestions are provided to help users fill out the form more quickly, so they can submit the address for validation and get a candidate back.

There are many factors that affect candidates and suggestions, but it's more than we can fit in this answer. For a more in-depth look at what our API gives you, keep reading.

Multiple candidates

Sometimes an address will have multiple valid candidates. Here's an example:

Input: 1109 9th Phoenix, AZ
Candidate 1: 1109 S 9th Ave, Phoenix AZ 85007-3646
Candidate 2: 1109 N 9th St, Phoenix AZ 85006-2734

There are two address matches (candidates) on that street: one on the north side, the other on the south side. Both are valid addresses, so you'd need to present these two options back to the user. Remember: customers typically know their addresses better than any computer will.

Keep in mind that addresses are very messy. Don't make too many assumptions about how the address might be wrong. If our system indicates an address is invalid, present it to the user and ask them to verify the information.

Address suggestions

Autocomplete functionality can be easily added to your application. You'll just need to build a request to the Autocomplete API.

With our US Autocomplete API, you can filter address suggestions based on cities and/or states. That way, if you only serve customers in, say, Montana, you can restrict the autocomplete to only show Montana address suggestions.

More aggressive address suggestions

If you need a more aggressive approach to getting address suggestions, you can create a workaround using our API. 

For example, if you have a sample address and want to see which valid addresses might be nearby, you could send a batch request for 1–100 North Main and then display the results. That would allow you to present suggestions to your users if the requested address is invalid. If you submit 100 North Main #1, 100 North Main #2... (or a, b, c), you can also return secondary (apartment) number suggestions to your users. 

(Note: Keep in mind that each request you send to our API counts as a lookup.)