Quickstart#

Introduction#

Welcome to the Global Express Entry Web Service 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).

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Express Free Form#

The ExpressFreeForm endpoint is provided as a means of retrieving all available U.S. address elements with a Free Form query. ExpressFreeForm returns:

  • AddressLine1

  • City

  • State

  • PostalCode

  • AddressKey

  • SuiteName

  • SuiteCount

  • SuiteList

  • PlusFour

Endpoint#

/jsonp/ExpressFreeform, /web/ExpressFreeForm

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
curl -X GET "https://expressentry.melissadata.net/jsonp/ExpressFreeForm?\
&cols=\
&format=jsonp\
&id={{customerId}}\
&maxrecords=10\
&opt=\
&ff=Rancho+Santa+Margarita,+CA+92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

curl -X GET "https://expressentry.melissadata.net/web/ExpressFreeForm?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&opt=\
&ff=Rancho+Santa+Margarita,+CA+92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

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

Express Address#

The ExpressAddress service is consumed to retrieve U.S. results containing all of the available address elements of an address record: AddressLine1, City, State, PostalCode, SuiteName, SuiteRange, and SuiteCount.

A typical use of the ExpressAddress method is preceded by a call to the ExpressPostalCode service. The ExpressPostalCode service is provided as a means of retrieving postal code, city, and state combinations using the postal code as the search input.

Endpoint#

/jsonp/ExpressAddress, /web/ExpressAddress

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
curl -X GET "https://expressentry.melissadata.net/jsonp/ExpressAddress?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&opt=\
&city=Rancho+Santa+Margarita\
&line1=\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

curl -X GET "https://expressentry.melissadata.net/web/ExpressAddress?\
&cols=\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&opt=\
&city=Rancho+Santa+Margarita\
&line1=\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/ExpressAddress?\
&cols=\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&opt=\
&city=Rancho+Santa+Margarita\
&line1=\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/xml" \
-H "Accept: */*"

Express City State#

ExpressCityState is provided as a means of retrieving U.S. city, state, and postal code combinations using the city name. This can be useful when a list of postal code information for a city is desired.

Endpoint#

/jsonp/ExpressCityState, /web/ExpressCityState

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
curl -X GET "https://expressentry.melissadata.net/jsonp/ExpressCityState?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&city=Rancho+Santa+Margarita\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

curl -X GET "https://expressentry.melissadata.net/web/ExpressCityState?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&city=Rancho+Santa+Margarita\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X GET "https://expressentry.melissadata.net/web/ExpressCityState?\
&format=xml\
&id={{customerId}}\
&maxrecords=10\
&city=Rancho+Santa+Margarita\
&postalcode=92688\
&state=CA\
-H "Content-Type: application/xml" \
-H "Accept: */*"

Express Postal Code#

ExpressPostalCode is provided as a convenient method for quickly retrieving U.S. city and state information using the ZIP code as the input. A subsequent call to ExpressAddress benefits greatly by using the city and state information from ExpressPostalCode.

Endpoint#

/jsonp/ExpressPostalCode, /web/ExpressPostalCode

Click here to go to the full endpoint documentation.

Try it Now#

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

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

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

Express Street#

ExpressStreet is a means for retrieving the streets (U.S.) within a ZIP Code using the ZIP Code and beginning of the street name (line 1) as the Input.

Endpoint#

/jsonp/ExpressStreet, /web/ExpressStreet

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
curl -X GET "https://expressentry.melissadata.net/jsonp/ExpressStreet?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&line1=22382+Avenida+Empresa\
&postalcode=92688\
-H "Content-Type: application/javascript" \
-H "Accept: application/javascript"

curl -X GET "https://expressentry.melissadata.net/web/ExpressStreet?\
&format=json\
&id={{customerId}}\
&maxrecords=10\
&line1=22382+Avenida+Empresa\
&postalcode=92688\
-H "Content-Type: application/json" \
-H "Accept: application/json"

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

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#

/jsonp/GlobalExpressFreeForm, /web/GlobalExpressFreeForm

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
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"

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: */*"

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#

/jsonp/GlobalExpressAddress, /web/GlobalExpressAddress

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
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"

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: */*"

Global Express Locality Administrative Area#

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

Endpoint#

/jsonp/GlobalExpressLocalityAdministrativeArea, /web/GlobalExpressLocalityAdministrativeArea

Click here to go to the full endpoint documentation.

Try it Now#

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

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

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#

/jsonp/GlobalExpressPostalCode, /web/GlobalExpressPostalCode

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
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"

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: */*"

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#

/jsonp/GlobalExpressThoroughfare, /web/GlobalExpressThoroughfare

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSONP
  • GET JSON
  • GET XML
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"

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: */*"

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#

/jsonp/GlobalExpressCountry, /web/GlobalExpressCountry

Click here to go to the full endpoint documentation.

Try it Now#

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

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: */*"

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/GlobalExpressEntry-Dotnet

Python3

melissa_favicon MelissaData/GlobalExpressEntry-Python3

Postman Collection

melissa_favicon MelissaData/GlobalExpressEntry-Postman