Returning Multiple Matches

If ValidateAddressLoqate finds multiple address in the postal database that are possible matches for the input address, you can have ValidateAddressLoqate return the possible matches. For example, the following address matches multiple addresses in the U.S. postal database:

PO BOX 1 New York, NY


To return multiple matches, use the options described in the following table.

Table 1. Multiple Match Option

Description/Valid Values

Indicates whether or not to return multiple address for those input addresses that have more than one possible match.

number between 1 and 10 that indicates the maximum number of addresses to return. The default value is 1.

Note: The difference between and is that a multiple match will return a failure if, whereas a multiple match will return one record if.

To identify which output addresses are candidate addresses, you must. When you do this, records that are candidate addresses will have one or more "M" values in the field-level result indicators.


When you choose to return multiple matches, the addresses are returned in the address format you specify. For information on specifying address format, see Options. To identify which records are the candidate addresses, look for multiple "M" values in the field-level result indicators. For more information, see Result Indicators.