Quickstart

Quickstart#

Introduction#

Welcome to the Global Express Entry Cloud API by Melissa. Global Express Entry is an auto-complete address verification service that will complete your query with a verified address, including city, state, and postal code with 50% fewer keystrokes.

Global Express Entry can be used to:

  • Complete free form partial address input with standardized and verified addresses.

  • Return geocoding coordinates along with address (in supported countries).

  • Filter output by state, distance from a lat/long point, Residence or Business, or ZIP Code (U.S. only).

New to Melissa Cloud APIs?#

We highly recommend first time users of our web services 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?#

Global Express Free Form#

The GlobalExpressFreeForm service is provided as a means of retrieving all available address elements using a free form search. GlobalExpressFreeForm returns:

  • FormattedAddress

  • AddressLine1-8

  • CountryISO3166_1_Alpha2

  • CountryISO3166_1_Alpha3

  • CountryISO3166_1_Numeric

  • SubNationalArea

  • PremisesNumber

  • AdministrativeArea

  • SubadministrativeArea

  • locality

  • dependentlocality

  • doubledependentlocality

  • thoroughfare

  • dependentthoroughfare

  • building

  • postalcode

  • postbox

Endpoint#

/web/GlobalExpressFreeForm

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressFreeForm?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&opt=\
&country=US\
&ff=22382+Avenida+Empresa,+Rancho+Santa+Margarita,+CA+92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressFreeForm?\
&cols=\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&opt=\
&country=US\
&ff=22382+Avenida+Empresa,+Rancho+Santa+Margarita,+CA+92688\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressFreeForm?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&opt=\
&country=US\
&ff=22382+Avenida+Empresa,+Rancho+Santa+Margarita,+CA+92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

Global Express Address#

The GlobalExpressAddress service is consumed to retrieve results containing all of the available address elements of an address record:

  • FormattedAddress

  • AddressLine1-8

  • CountryISO3166_1_Alpha2

  • CountryISO3166_1_Alpha3

  • CountryISO3166_1_Numeric

  • SubNationalArea

  • PremisesNumber

  • AdministrativeArea

  • SubadministrativeArea

  • locality

  • dependentlocality

  • doubledependentlocality

  • thoroughfare

  • dependentthoroughfare

  • building

  • postalcode

  • postbox

A typical use of the GlobalExpressAddress method is preceded by a call to the GlobalExpressPostalCode service. The GlobalExpressPostalCode service is provided as a means of retrieving postal code, locality, and administrative area combinations using the postal code as the search input.

Endpoint#

/web/GlobalExpressAddress

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressAddress?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=True\
&opt=\
&address1=\
&administrativearea=CA\
&country=US\
&locality=Rancho+Santa+Margarita\
&postalcode=92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressAddress?\
&cols=\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=True\
&opt=\
&address1=\
&administrativearea=CA\
&country=US\
&locality=Rancho+Santa+Margarita\
&postalcode=92688\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressAddress?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=True\
&opt=\
&address1=\
&administrativearea=CA\
&country=US\
&locality=Rancho+Santa+Margarita\
&postalcode=92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

Global Express Locality Administrative Area#

GlobalExpressLocalityAdministrativeArea is provided as a means of retrieving locality and administrative area combinations using the locality name.

Endpoint#

/web/GlobalExpressLocalityAdministrativeArea

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressLocalityAdministrativeArea?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&country=US\
&locality=Rancho+Santa+Margarita\
&administrativearea=CA\
&postalcode=92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressLocalityAdministrativeArea?\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&country=US\
&locality=Rancho+Santa+Margarita\
&administrativearea=CA\
&postalcode=92688\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressLocalityAdministrativeArea?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&nativecharset=true\
&country=US\
&locality=Rancho+Santa+Margarita\
&administrativearea=CA\
&postalcode=92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

Global Express Postal Code#

GlobalExpressPostalCode is provided as a convenient method for quickly retrieving locality and administrative area information using the postal code as the input. A subsequent call to GlobalExpressAddress benefits greatly by using the locality and administrative area information from GlobalExpressPostalCode with GlobalExpressLocalityAdministrativeArea.

Endpoint#

/web/GlobalExpressPostalCode

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressPostalCode?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressPostalCode?\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressPostalCode?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

Global Express Thoroughfare#

GlobalExpressThroughfare is a means for retrieving the thoroughfares within a Postal Code using the Postal Code and beginning of the thoroughfare name as the inputs.

Endpoint#

/web/GlobalExpressThoroughfare

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressThoroughfare?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
&thoroughfare=Avenida+Empresa\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressThoroughfare?\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
&thoroughfare=Avenida+Empresa\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressThoroughfare?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&country=US\
&postalcode=92688\
&thoroughfare=Avenida+Empresa\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

Global Express Country#

The GlobalExpressCountry endpoint returns the country names containing the search term in the Country= parameter. Country names in five languages are returned:

  • English

  • Spanish

  • French

  • German

  • Simplified Chinese.

Endpoint#

/web/GlobalExpressCountry

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • GET XML
  • GET JSONP
curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressCountry?\
&format=json\
&id={{customerId}}\
&country=US\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/GlobalExpressCountry?\
&format=xml\
&id={{customerId}}\
&country=US\
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X GET "https://expressentry.melissadata.net/jsonp/GlobalExpressCountry?\
&format=json\
&id={{customerId}}\
&country=US\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"
Contents