Returning Multiple Matches

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

New York, NY


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

Table 1. Multiple Match Option




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

Yes, return multiple matches (default).
No, do not return multiple matches.


A number between 1 and 10 that indicates the maximum number of addresses to return.

The default value is 1.

Note: The difference between Option.Keepmultimatch=N and Option.KeepMultimatch=Y/Option.MaximumResults=1 is that a multiple match will return a failure if Option.KeepMultimatch=N, whereas a multiple match will return one record if Option.KeepMultimatch=Y and Option.MaximumResults=1.


To identify which output addresses are candidate addresses, you must specify a value of Y for Option.OutputFieldLevelReturnCodes. 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 Output Data Options. To identify which records are the candidate addresses, look for multiple "M" values in the field-level result indicators. For more information, see Field-Level Result Indicators.