Global Match Code - Precisely Data Integrity Suite

Data Integrity Suite APIs
Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

The Address Verification Global Match Code is a system that evaluates how address fields are matched or modified during the address verification process. This system helps standardize and validate input addresses by comparing them with postal reference datasets, ensuring greater accuracy and consistency.

There are two forms of Global Match Codes:

  • Extended Match Code: Provides detailed information about all address component fields.
  • Simple Match Code: Focuses on the status of a subset of address component fields.
Note: A new component, N, has been added to the extended match code to represent placename matches. This enhancement provides greater transparency and granularity in match‑code interpretation, especially for workflows involving POI or place name parsing
  • This allows clients to more easily distinguish between:
    • Standard address element matches
    • Place name‑specific matches

Examples of Global Match Codes

Simple Global Match Code:

V4-P4S4A0T4R6Z4C4-5

Extended Global Match Code

V4-D0M0B0U4F0G0P4S4Q0X0A0T4E0R6W0Z4Y4C4-5

Structure of the Global Match Code

The Global Match Code is divided into three segments separated by dashes (-):
  • Address Match Status

  • Component Match Status

  • Match Confidence

Address Match Status

This segment consists of a letter followed by a number, representing the match status of the address and the verification level.

Status Codes:

  • V – Verified: A complete match with a single record in the reference data.
  • M – Multiple Matches: The input matches more than one possible address in the reference data.
  • U – Unmatched: No matches found.
    Note: Status codes M and U are not yet supported.
Verification Levels: Numeric values indicate the level of verification. Higher values represent higher levels of validation.
Table 1.
Level Description
4 Premise verified
3 Street verified
2 Postcode/City/Country verified.
1 City and country verified

Component Match Status

This segment indicates the status of individual address components. Each component is represented by a label and a numeric value.

Simple Example:

P4S4A0T4R6Z4C4

  • P4: Premise verified without changes.
  • S4: Street verified without changes.
  • A0: Sub-city not found.
  • T4: City verified without changes.
  • R6: Region appended using reference data.
  • Z4: Postcode verified without changes.
  • C4: Country verified without changes.

Extended Example:

D0M0B0U4F0G0P4S4Q0X0A0T4E0R6W0Z4Y4C4

This format includes additional components such as building, sub-premise, sub-street, and PO Box.

Component Labels:
Table 2.
Label Component Description
D Department Government/organizational departments.
M Company Business or company name.
B Building Building name or identifier.
N Place name Place name or identifier.
U Sub-premise/Unit Apartment or unit number.
F Sub-premise2/Floor Floor or level within a building.
G Sub-premise3/Room Room number within a building.
P Premise/House Number Street address number.
S Street Name of the street.
Q Sub-street Additional street-level identifiers.
X PO Box Post office box.
A Sub-city Neighborhood or district.
T City City or town name.
E Extra City Secondary city reference.
R Region/State State or province.
W Principality Administrative region.
Z Postcode/Zip Code Postal or ZIP code.
Y Extra Postcode/Zip+4 Additional postal/ZIP code detail.
C Country Country name.
Numeric Values for Status:
Table 3.
Value Status
0 Not found or empty
1 Parsed and standardized but not identified in reference data.
2 Not identified; reference data suggests the component is out of range or unknown.
3 Verified and corrected using reference data.
4 Verified without changes using reference data.
5 Verified using a reference data alias.
6 Appended using reference data.

Match Confidence

The final segment indicates the confidence level of the match. This value compares the standardized input address with the matched postal reference data.
Table 4.
Value Confidence Level
5 High Confidence
4 Moderate-High Confidence
3 Medium Confidence
2 Medium-Low Confidence
1 Low Confidence
0 No Confidence

The Address Verification Global Match Code system provides a structured way to assess and validate address data. By breaking the process into three clear segments—Address Match Status, Component Match Status, and Match Confidence—it ensures a thorough evaluation of input addresses against reference datasets. This system is crucial for improving the accuracy of address-based services in applications such as logistics, e-commerce, and government systems.