Other

Other#

Data Coverage by Country#

See 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

OFF

Default. No alternate address suggestions are provided.

ON

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
19217 36th Ave W Ste 21
Lynnwood WA 98036
US

Premise Partial (AV14)

Suggestions may include valid sub premise numbers and the best address.
19217 36th Ave W Ste 210
Lynnwood WA 98036-5751
US
1 Frederick’s Place
London
EC2R 8AB
GB

Thoroughfare Partial (AV13)

Suggestions may include valid premise numbers found on the street/thoroughfare.
4A Frederick’s Place
London
EC2R 8AB
GB
4925 Oggdin St
Pittsburgh PA
US

Locality Partial (AV12)

Suggestions may match to multiple addresses using all major address components.
4925 Odin St
Pittsburgh PA 15207-1644
US
10150 126 Ave
Grande Prairie AB T8V 8H1
CA

General Error (AE01)

Suggestions may return multiple addresses using all major address components. Quality of the input will directly affect the results.
10215 126 Ave
Grande Prairie AB T8V 2R5
CA
103 St Ann Pl
Dallas GA 30157
US

Multiple Match (AE05)

Suggestions will provide all addresses that may have matched during the initial address validation.
103 St Ann St
Dallas GA 30157-8029
US

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.

Contents