Global Address Verification Quickstart#

Introduction#

Global Address Verification can verify and standardize mailing addresses from across the world with the flexibility and accuracy delivered by Melissa products.

Global Address can be used to:

  • Verify, Correct, & Standardize addresses from 250+ countries & territories

  • Append latitude & longitude

  • Return address as parsed components

  • Return address in mailing label format according to the standards of each country

  • Append additional information like unique identifier, delivery indicator, & more depending on the country.

  • Standardized addresses with extended and UTF-8 characters will return responses with the proper UTF-8 / accented characters.

New to Melissa Cloud APIs?#

We highly recommend first time users of our Cloud APIs to review our Using Melissa Cloud APIs section. It will cover critical topics like:

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Explore Melissa Lookups#

Check out Global Address Verification lookups here for the full experience.

Address Verification#

Global Address Verification can check and validate a given address.

Endpoint#

/V3/WEB/GlobalAddress/doGlobalAddress

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML
curl -X GET "https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress?\
&format=JSON\
&id={{customerId}}\
&opt=USPreferredCityNames:ON,OutputGeo:ON\
&t=Test\
&a1=22382%20Avenida%20Empresa\
&admarea=CA\
&ctry=US\
&loc=Rancho%20Santa%20Margarita\
&org=Melissa\
&postal=92688" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
curl -X POST "https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
      "CustomerID": "{{customerId}}",
      "Options": "USPreferredCityNames:ON,OutputGeo:ON",
      "Records":
      [{
        "AddressLine1": "22382 Avenida Empresa",
        "AdministrativeArea": "CA",
        "Country": "US",
        "Locality": "Rancho Santa Margarita",
        "Organization": "Melissa",
        "PostalCode": "92688",
        "RecordID": "1"
      },
      {
        "AddressLine1": "Caecilienstr. 42-44",
        "Country": "Germany",
        "Locality": "Cologne",
        "Organization": "Melissa",
        "PostalCode": "50667",
        "RecordID": "2"
      }],
      "TransmissionReference": "Test"
    }
   '
curl -X GET "https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress?\
&format=XML\
&id={{customerId}}\
&opt=USPreferredCityNames:ON,OutputGeo:ON\
&t=Test\
&a1=22382%20Avenida%20Empresa\
&admarea=CA\
&ctry=US\
&loc=Rancho%20Santa%20Margarita\
&org=Melissa\
&postal=92688" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml"
curl -X POST "https://address.melissadata.net/V3/WEB/GlobalAddress/doGlobalAddress" \
-H "Content-Type: application/xml" \
-H "Accept: */*" \
-d '<Request>
      <CustomerID>{{customerId}}</CustomerID>
      <Options>USPreferredCityNames:ON,OutputGeo:ON</Options>
      <Records>
        <RequestRecord>
          <AddressLine1>22382 Avenida Empresa</AddressLine1>
          <AdministrativeArea>CA</AdministrativeArea>
          <Country>US</Country>
          <Locality>Rancho Santa Margarita</Locality>
          <Organization>Melissa</Organization>
          <PostalCode>92688</PostalCode>
          <RecordID>1</RecordID>
        </RequestRecord>
        <RequestRecord>
          <AddressLine1>Caecilienstr. 42-44</AddressLine1>
          <Country>Germany</Country>
          <Locality>Cologne</Locality>
          <Organization>Melissa</Organization>
          <PostalCode>50667</PostalCode>
          <RecordID>2</RecordID>
        </RequestRecord>
      </Records>
      <TransmissionReference>Test</TransmissionReference>
    </Request>
   '

Inputs and Outputs#

The table below shows the most common inputs and outputs for this endpoint.

For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML

Inputs

Outputs

a1

a2

a3

a4

a5

a6

a7

a8

admarea

ctry

ddeploc

deploc

format

id

last

loc

opt

org

postal

subadmarea

subnatarea

t

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

RecordID

Results

FormattedAddress

Record Level Response Fields

Organization

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

SubPremises

DoubleDependentLocality

DependentLocality

Locality

SubAdministrativeArea

AdministrativeArea

PostalCode

PostalCodeType

Appended Address Record Elements

AddressType

AddressKey

SubNationalArea

CountryName

CountryISO3166_1_Alpha2

CountryISO3166_1_Alpha3

CountryISO3166_1_Numeric

CountrySubdivisionCode

Thoroughfare

ThoroughfarePreDirection

ThoroughfareLeadingType

ThoroughfareName

ThoroughfareTrailingType

ThoroughfarePostDirection

DependentThoroughfare

DependentThoroughfarePreDirection

DependentThoroughfareLeadingType

DependentThoroughfareName

DependentThoroughfareTrailingType

DependentThoroughfarePostDirection

Building

PremisesType

PremisesNumber

SubPremisesType

SubPremisesNumber

PostBox

Latitude

Longitude

DeliveryIndicator

MelissaAddressKey

MelissaAddressKeyBase

PostOfficeLocation

SubPremiseLevel

SubPremiseLevelType

SubPremiseLevelNumber

SubBuilding

SubBuildingType

SubBuildingNumber

UTC

DST

DeliveryPointSuffix

CensusKey

Suggestions

Inputs

Outputs

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

AdministrativeArea

Country

CustomerID

DependentLocality

DoubleDependentLocality

LastName

Locality

Options

Organization

PostalCode

RecordID

SubAdministrativeArea

SubNationalArea

TransmissionReference

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

RecordID

Results

FormattedAddress

Record Level Response Fields

Organization

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

SubPremises

DoubleDependentLocality

DependentLocality

Locality

SubAdministrativeArea

AdministrativeArea

PostalCode

PostalCodeType

Appended Address Record Elements

AddressType

AddressKey

SubNationalArea

CountryName

CountryISO3166_1_Alpha2

CountryISO3166_1_Alpha3

CountryISO3166_1_Numeric

CountrySubdivisionCode

Thoroughfare

ThoroughfarePreDirection

ThoroughfareLeadingType

ThoroughfareName

ThoroughfareTrailingType

ThoroughfarePostDirection

DependentThoroughfare

DependentThoroughfarePreDirection

DependentThoroughfareLeadingType

DependentThoroughfareName

DependentThoroughfareTrailingType

DependentThoroughfarePostDirection

Building

PremisesType

PremisesNumber

SubPremisesType

SubPremisesNumber

PostBox

Latitude

Longitude

DeliveryIndicator

MelissaAddressKey

MelissaAddressKeyBase

PostOfficeLocation

SubPremiseLevel

SubPremiseLevelType

SubPremiseLevelNumber

SubBuilding

SubBuildingType

SubBuildingNumber

UTC

DST

DeliveryPointSuffix

CensusKey

Suggestions

Inputs

Outputs

a1

a2

a3

a4

a5

a6

a7

a8

admarea

ctry

ddeploc

deploc

format

id

last

loc

opt

org

postal

subadmarea

subnatarea

t

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

RecordID

Results

FormattedAddress

Record Level Response Fields

Organization

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

SubPremises

DoubleDependentLocality

DependentLocality

Locality

SubAdministrativeArea

AdministrativeArea

PostalCode

PostalCodeType

Appended Address Record Elements

AddressType

AddressKey

SubNationalArea

CountryName

CountryISO3166_1_Alpha2

CountryISO3166_1_Alpha3

CountryISO3166_1_Numeric

CountrySubdivisionCode

Thoroughfare

ThoroughfarePreDirection

ThoroughfareLeadingType

ThoroughfareName

ThoroughfareTrailingType

ThoroughfarePostDirection

DependentThoroughfare

DependentThoroughfarePreDirection

DependentThoroughfareLeadingType

DependentThoroughfareName

DependentThoroughfareTrailingType

DependentThoroughfarePostDirection

Building

PremisesType

PremisesNumber

SubPremisesType

SubPremisesNumber

PostBox

Latitude

Longitude

DeliveryIndicator

MelissaAddressKey

MelissaAddressKeyBase

PostOfficeLocation

SubPremiseLevel

SubPremiseLevelType

SubPremiseLevelNumber

SubBuilding

SubBuildingType

SubBuildingNumber

UTC

DST

DeliveryPointSuffix

CensusKey

Suggestions

Inputs

Outputs

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

AdministrativeArea

Country

CustomerID

DependentLocality

DoubleDependentLocality

LastName

Locality

Options

Organization

PostalCode

RecordID

SubAdministrativeArea

SubNationalArea

TransmissionReference

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

RecordID

Results

FormattedAddress

Record Level Response Fields

Organization

AddressLine1

AddressLine2

AddressLine3

AddressLine4

AddressLine5

AddressLine6

AddressLine7

AddressLine8

SubPremises

DoubleDependentLocality

DependentLocality

Locality

SubAdministrativeArea

AdministrativeArea

PostalCode

PostalCodeType

Appended Address Record Elements

AddressType

AddressKey

SubNationalArea

CountryName

CountryISO3166_1_Alpha2

CountryISO3166_1_Alpha3

CountryISO3166_1_Numeric

CountrySubdivisionCode

Thoroughfare

ThoroughfarePreDirection

ThoroughfareLeadingType

ThoroughfareName

ThoroughfareTrailingType

ThoroughfarePostDirection

DependentThoroughfare

DependentThoroughfarePreDirection

DependentThoroughfareLeadingType

DependentThoroughfareName

DependentThoroughfareTrailingType

DependentThoroughfarePostDirection

Building

PremisesType

PremisesNumber

SubPremisesType

SubPremisesNumber

PostBox

Latitude

Longitude

DeliveryIndicator

MelissaAddressKey

MelissaAddressKeyBase

PostOfficeLocation

SubPremiseLevel

SubPremiseLevelType

SubPremiseLevelNumber

SubBuilding

SubBuildingType

SubBuildingNumber

UTC

DST

DeliveryPointSuffix

CensusKey

Suggestions