Global Express Entry 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 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#

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"

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.

Inputs

Outputs

Request Level Parameters

cols

diacriticreplace

format

id

maxrecords

nativecharset

opt

suitecompression

t

Record Level Parameters

country

ff

Service Level Response Fields

Version

ResultCode

ErrorString

Results

Record Level Response Fields

Address

Address1

Address2

Address3

Address4

Address5

Address6

Address7

Address8

Address9

Address10

Address11

Address12

DeliveryAddress

DeliveryAddress1

DeliveryAddress2

DeliveryAddress3

DeliveryAddress4

DeliveryAddress5

DeliveryAddress6

DeliveryAddress7

DeliveryAddress8

DeliveryAddress9

DeliveryAddress10

DeliveryAddress11

DeliveryAddress12

CountryName

ISO3166_2

ISO3166_3

ISO3166_N

SuperAdministrativeArea

AdministrativeArea

SubAdministrativeArea

Locality

CityAccepted

CityNotAccepted

DependentLocality

DoubleDependentLocality

Thoroughfare

DependentThoroughfare

Building

Premise

SubBuilding

PostalCode

PostalCodePrimary

PostalCodeSecondary

Organization

PostBox

Unmatched

GeneralDelivery

DeliveryInstallation

Route

AdditionalContent

CountrySubdivisionCode

MAK

BaseMAK

Latitude

Longitude

DistanceFromPoint

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"