Quickstart#

Introduction#

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

Global Address can be used to:

  • Verify, Correct, & Standardize addresses from 240+ 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.

Using the Service#

There are two ways to use the service: Subscription or Credit.

Subscription#

  • Free trial

  • Volume discounts. Cheaper than credits.

  • Full technical support

For more information on subscriptions, click here.

Credit#

  • 15 credits per check ($3 for 1000 credits)

  • Free monthly credit top off to 1,000 credits

  • No commitments/Instant Access

For more information on credits, click here.

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Global Address Verification can check and validate a given address.

/V3/WEB/GlobalAddress/doGlobalAddress

Click here to go to the full endpoint documentation.

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

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/GlobalAddressVerification-Dotnet

Python3

melissa_favicon MelissaData/GlobalAddressVerification-Python3

Postman Collection

melissa_favicon MelissaData/GlobalAddressVerification-Postman