Global Address Verification Other#
Data Coverage by Country#
Address Suggestions (Beta) — Best Practices#
The Suggestion request option enhances address verification by returning alternatives when the original input is incomplete, ambiguous, or cannot be fully verified. This helps users correct, complete, and standardize address input in real time.
Usage & Availability#
The Suggestion option is intended for single-record, real-time workflows, such as form validation or CRM data entry, to help complete or correct the original input address. It does not support multi-record requests. Availability varies by country and may change as the feature evolves; please contact your sales representative for current coverage.
Enabling Suggestions#
To enable address suggestions within Global Address Verification, set the Suggestion request option in your API request.
Parameter |
Description |
|---|---|
|
Default. No alternate address suggestions are provided. |
|
Alternate address suggestions are provided in the Suggestions field. Suggestions are not guaranteed for all partially verified or invalid addresses. |
Example Request#
curl -X POST "https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"CustomerID": "{{customerId}}",
"Options": "Suggestion:ON",
"Records":
[{
"AddressLine1": "19217 36th Ave W Ste 21",
"Locality": "Lynnwood",
"AdministrativeArea": "WA",
"PostalCode": "98036",
"Country": "US",
"RecordID": "1"
}],
"TransmissionReference": "Test"
}
'
Response Snippet#
"Suggestions": [
{
"RecordID": "1",
"FormattedAddress": "19217 36th Ave W Ste 210, Lynnwood, WA 98036-5751",
"Organization": "",
"AddressLine1": "19217 36th Ave W 210",
"AddressLine2": "",
"SubPremises": "210",
"DoubleDependentLocality": "",
"DependentLocality": "",
"Locality": "Lynnwood",
"AdministrativeArea": "WA",
"PostalCode": "98036-5751",
"SubNationalArea": "",
"CountryName": "United States",
"CountryISO3166_1_Alpha2": "US",
"CountryISO3166_1_Alpha3": "USA",
"CountryISO3166_1_Numeric": "840",
"CountrySubdivisionCode": "US-WA",
"Thoroughfare": "36th Ave W",
"PostBox": "",
"Latitude": "47.824235",
"Longitude": "-122.280195",
"MelissaAddressKey": "5706681246",
"MelissaAddressKeyBase": "7987196721"
},
{
"RecordID": "2",
"FormattedAddress": "19217 36th Ave W Ste 213, Lynnwood, WA 98036-5751",
"Organization": "",
"AddressLine1": "19217 36th Ave W 213",
"AddressLine2": "",
"SubPremises": "213",
"DoubleDependentLocality": "",
"DependentLocality": "",
"Locality": "Lynnwood",
"AdministrativeArea": "WA",
"PostalCode": "98036-5751",
"SubNationalArea": "",
"CountryName": "United States",
"CountryISO3166_1_Alpha2": "US",
"CountryISO3166_1_Alpha3": "USA",
"CountryISO3166_1_Numeric": "840",
"CountrySubdivisionCode": "US-WA",
"Thoroughfare": "36th Ave W",
"PostBox": "",
"Latitude": "47.824235",
"Longitude": "-122.280195",
"MelissaAddressKey": "7977577506",
"MelissaAddressKeyBase": "7987196721"
}
]
Results Interpretation#
Up to 50 address suggestions may be returned, generally ranked with the most relevant results at the top of the list. However, ranking is not guaranteed, and manual review is recommended to evaluate the helpfulness of the returned suggestions. Suggestion relevance is influenced by the quality and structure of the input address, with higher-quality inputs typically producing more useful results.
Result Code Scenarios#
Example Input
Verification Result
Suggestion Behavior
Suggestion
Premise Partial (AV14)
Suggestions may include valid sub premise numbers and the best address.
Thoroughfare Partial (AV13)
Suggestions may include valid premise numbers found on the street/thoroughfare.
Locality Partial (AV12)
Suggestions may match to multiple addresses using all major address components.
General Error (AE01)
Suggestions may return multiple addresses using all major address components. Quality of the input will directly affect the results.
Multiple Match (AE05)
Suggestions will provide all addresses that may have matched during the initial address validation.
Result Codes#
SG01 – Suggestions were successfully generated.
SG02 – Suggestions could not be generated for the input.
SG99 – An internal processing issue occurred; retrying the request may succeed.
Implementation Considerations#
The Suggestion option is intended as an assistive tool, helping direct users toward valid addresses rather than enforcing a single correct result. Because expected addresses may not always appear in the list, suggestions should be presented as optional replacements rather than applied automatically, especially in customer-facing applications.
Enabling Suggestion may increase response times compared to standard verification due to additional processing. As a beta feature, supported countries, ranking logic, behavior, and performance may change without notice as the feature evolves.
Supported Countries#
Address suggestions are currently supported in the following countries:
Country |
Code |
|---|---|
American Samoa |
AS |
Argentina |
AR |
Australia |
AU |
Austria |
AT |
Belgium |
BE |
Bosnia and Herzegovina |
BA |
Brazil |
BR |
Canada |
CA |
Chile |
CL |
Colombia |
CO |
Croatia |
HR |
Czechia |
CZ |
Denmark |
DK |
Ecuador |
EC |
Finland |
FI |
France |
FR |
Germany |
DE |
Greece |
GR |
Guam |
GU |
Hong Kong |
HK |
Hungary |
HU |
Iceland |
IS |
India |
IN |
Indonesia |
ID |
Ireland |
IE |
Italy |
IT |
Korea, Republic Of |
KR |
Kuwait |
KW |
Luxembourg |
LU |
Malaysia |
MY |
Marshall Islands |
MH |
Mexico |
MX |
Micronesia, Federated States of |
FM |
Morocco |
MA |
Netherlands |
NL |
New Zealand |
NZ |
Northern Mariana Islands |
MP |
Norway |
NO |
Palau |
PW |
Peru |
PE |
Philippines |
PH |
Poland |
PL |
Portugal |
PT |
Puerto Rico |
PR |
Romania |
RO |
Singapore |
SG |
Slovakia |
SK |
Slovenia |
SI |
South Africa |
ZA |
Spain |
ES |
Sweden |
SE |
Switzerland |
CH |
Taiwan |
TW |
Thailand |
TH |
Turkiye |
TR |
United Arab Emirates |
AE |
United Kingdom |
GB |
United States Minor Outlying Islands |
UM |
United States of America |
US |
Viet Nam |
VN |
Virgin Islands, U.S. |
VI |