Match Code

Extended Match Codes

The Extended Match Codes option enables the return of additional information about any changes in the house number, unit number and unit type fields. In addition, it can indicate whether there was address information that was ignored. The Extended Match Code is only returned for address-level matches (match codes that begin with A, G, H, J, Q, R, S, T or U), in which case a 3rd hex digit is appended to the match code (see Match Codes).

Note: A typical match code contains up to 4 characters: a beginning alpha character followed by 2 or 3 hex digits. The third hex digit is only populated for intersection matches or as part of the Extended Match Code.
For information about the 3rd hex digit values for:
"Address information ignored" is specified when any of these conditions apply:
  • The output address has content in the AdditionalInputData field.
  • The output address has a second address line (AddressLine2).
  • The input address is a dual address (two complete addresses in the input address). For example, "4750 Walnut St. P.O Box 50".
  • The input last line has extra information that is not a city, state or ZIP Code, and is ignored. For example, "Boulder, CO 80301 USA", where "USA" is ignored when matching.

The table below provides descriptions of the Extended Match Code 3rd hex digit return values.

Input Addressline Output Addressline Extended Code Description
4750 WALNUT ST STE 200 4750 WALNUT ST STE 200 0 Matched on all address information on line, including Unit Number and Unit Type if included.
4750 WALNUT ST C/O JOE SMITH 4750 WALNUT ST 1 Matched on Unit Number and Unit Type if included. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
4750 WALNUT ST UNIT 200 4750 WALNUT ST STE 200 2 Matched on Unit Number. Unit Type changed.
4750 WALNUT ST UNIT 200 C/O JOE SMITH 4750 WALNUT ST STE 200 3 Matched on Unit Number. Unit Type changed. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
4750 WALNUT ST STE 2-00 4750 WALNUT ST STE 200 4 Unit Number changed or ignored.
4750 WALNUT ST STE 2-00 C/O JOE SMITH 4750 WALNUT ST STE 200 5 Unit Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
4750 WALNUT ST STE 400 4750 WALNUT ST STE 400 6 Unit Number changed or ignored. Unit Type changed or ignored. In this example, Suite 400 is not valid for the input address, but the address match is not prevented because of an invalid unit number.
4750 WALNUT ST UNIT 2-00 C/O JOE SMITH 4750 WALNUT ST STE 200 7 Unit Number changed or ignored. Unit Type changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
47-50 WALNUT ST STE 200 4750 WALNUT ST STE 200 8 Matched on Unit Number and Unit Type if included. House number changed or ignored.
47-50 WALNUT ST STE 200 C/O JOE SMITH 4750 WALNUT ST STE 200 9 Matched on Unit Number and Unit Type if included. House number changed or ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
47-50 WALNUT ST UNIT 200 4750 WALNUT ST STE 200 A Matched on Unit Number. Unit Type changed. House Number changed or ignored.
47-50 WALNUT ST UNIT 200 C/O JOE SMITH 4750 WALNUT ST STE 200 B Matched on Unit Number. Unit Type changed. House Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
47-50 WALNUT ST STE 20-0 4750 WALNUT ST STE 200 C House Number changed or ignored. Unit Number changed or ignored.
47-50 WALNUT ST STE 20-0 C/O JOE SMITH 4750 WALNUT ST STE 200 D House Number changed or ignored. Unit Number changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.
47-50 WALNUT ST UNIT 20-0 4750 WALNUT ST STE 200 E House Number changed or ignored. Unit Number changed or ignored. Unit Type changed or ignored.
47-50 WALNUT ST UNIT 2-00 C/O JOE SMITH 4750 WALNUT ST STE 200 F House Number changed or ignored. Unit Number changed or ignored. Unit Type changed or ignored. Extra information on address line ignored. Extra information not considered for matching moved to AddressLine2 or AdditionalInputData field.

Match Code Option

Parameter Description

Option.ExtendedMatchCode

Specifies whether to return the Extended Match Code. For more information, see Match Code.

Y
Yes, return the Extended Match Code.
N
No, do not return the Extended Match Code. Default.