Reference Guide

Introduction

Global Express Entry consists of a Web service and support code that enable more accurate and convenient entry of address data by checking data as it is typed. Adding to your code is simple: just implement a solution in Visual Studio or use Javascript to connect to the Web service (sample code is provided). The result will be less time and labor lost due to common errors such as misspellings and wrong ZIP codes. Express Entry enables you to accomplish this with a minimum of coding time and can reduce the number of keystrokes required to enter address data.

Global Express Entry can:

• Save time and effort by completing addresses with less than 1/2 of the keystrokes necessary to type the full address, checked against Melissa Data’s Multi-sourced data.

• Validate addresses while they are being typed in, making sure that as addresses are added, misspellings and other errors are prevented.

• Be implemented as a Web service client using REST in a language such as C#, Visual BASIC, or Javascript (examples provided).

• Respond quickly to requests, enabling the user to find related addresses easily.

• Correct for missing address components by adding elements such as suffixes where the user didn’t know they existed.

Base URL

https://expressentry.melissadata.net

Licensing

The License Key is a software key required to use the web service. You will receive your license key from your Melissa representative. If you don’t have a license key, contact the Melissa sales team at sales@melissa.com or 800-MELISSA ext. 3 (800-635-4772 ext. 3). Without a license key this service will not function.

To set the license key, use the id/CustomerID property in your requests.

Endpoints

/jsonp/ExpressFreeform
/web/ExpressFreeForm

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
cols	Specifies which column(s) to be output as a comma delimited string. See Columns for more information.
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
opt	Set Options poboxes
Address Parameters
ff	The free form address, with search terms delimited by %20 or a space.

Columns

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

Column	Returned Values
results	Return Address Object result codes for each address in the Extras field. For example, a USPS only address will return "AddrObjectResultCode": "AS01".
County	Return County Name field for CountyName in the Extras Object.

Options

List options in the following format, with multiple options delimited with a ;.

OptionName:Parameter;OptionName:Parameter

poboxes

This options allows P.O. Boxes and military addresses to be returned with U.S. Addresses.

Parameter	Description
true	U.S. Addresses will return P.O. Boxes and military addresses.
false	P.O. Boxes and military addresses will not be returned.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

Response

• GET JSONP

/jsonp/ExpressAddress

/web/ExpressAddress

Use this endpoint to retrieve U.S. results containing all of the available address elements of an address record: AddressLine1, City, State, PostalCode, SuiteName, SuiteRange, and SuiteCount.

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• GET JSONP
• GET JSON
• GET XML

curl -X GET "https://expressentry.melissadata.net/jsonp/ExpressAddress?\
&cols=\
&format=jsonp\
&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: application/xml"

Request Parameters

Code	Description
Record Level Parameters
cols	Specifies which column(s) to be output as a comma delimited string. See Columns for more information.
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
opt	Set Options poboxes
Address Parameters
city	City, Locality, Municipality. The most common population center data element.
line1	The input field for the address, delimited by %20 or a space. This should contain the street address information (house number, thoroughfare, building, suite, etc.)
postalcode	Postal Code, ZIP. The complete postal code.
state	Administrative Area, Province, State. The most common geographic data element.

Columns

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

Column	Returned Values
results	Return Address Object result codes for each address in the Extras field. For example, a USPS only address will return "AddrObjectResultCode": "AS01".
County	Return County Name field for CountyName in the Extras Object.

Options

List options in the following format, with multiple options delimited with a ;.

OptionName:Parameter;OptionName:Parameter

poboxes

This options allows P.O. Boxes and military addresses to be returned with U.S. Addresses.

Parameter	Description
true	U.S. Addresses will return P.O. Boxes and military addresses.
false	P.O. Boxes and military addresses will not be returned.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

Response

• GET JSONP
• GET JSON
• GET XML

{
  "Version":"string",
  "ResultCode":"string",
  "ErrorString":"string",
  "Results":[{
    "Address":{
      "AddressLine1":"string",
      "City":"string",
      "CityAccepted":"string",
      "CityNotAccepted":"string",
      "State":"string",
      "PostalCode":"string",
      "CountrySubdivisionCode","string",
      "AddressKey":"string",
      "SuiteName":"string",
      "SuiteCount":string,
      "SuiteList":"string",
      "PlusFour":"string",
      "MAK":"string",
      "BaseMAK":"string"
    }
  }]
}

{
  "Version":"string",
  "ResultCode":"string",
  "ErrorString":"string",
  "Results":[{
    "Address":{
      "AddressLine1":"string",
      "City":"string",
      "CityAccepted":"string",
      "CityNotAccepted":"string",
      "State":"string",
      "PostalCode":"string",
      "CountrySubdivisionCode","string",
      "AddressKey":"string",
      "SuiteName":"string",
      "SuiteCount":string,
      "SuiteList":"string",
      "PlusFour":"string",
      "MAK":"string",
      "BaseMAK":"string"
    }
  }]
}

<Response>
  <Version>string</Version>
  <ResultCode>string</ResultCode>
  <ErrorString>string</ErrorString>
  <Results>
    <Result>
      <Address>
        <AddressLine1>string</AddressLine1>
        <City>string</City>
        <CityAccepted>string</CityAccepted>
        <CityNotAccepted>string</CityNotAccepted>
        <State>string</State>
        <PostalCode>string</PostalCode>
        <CountrySubdivisionCode>string</CountrySubdivisionCode>
        <AddressKey>string</AddressKey>
        <SuiteName>string</SuiteName>
        <SuiteCount>string</SuiteCount>
        <SuiteList>string</SuiteList>
        <PlusFour>string</PlusFour>
        <MAK>string</MAK>
        <BaseMAK>string</BaseMAK>
      </Address>
    </Result>
    <Result>
      <Address>
        <AddressLine1>string</AddressLine1>
        <City>string</City>
        <CityAccepted>string</CityAccepted>
        <CityNotAccepted>string</CityNotAccepted>
        <State>string</State>
        <PostalCode>string</PostalCode>
        <CountrySubdivisionCode>string</CountrySubdivisionCode>
        <AddressKey>string</AddressKey>
        <SuiteName>string</SuiteName>
        <SuiteCount>string</SuiteCount>
        <SuiteList>string</SuiteList>
        <PlusFour>string</PlusFour>
        <MAK>string</MAK>
        <BaseMAK>string</BaseMAK>
      </Address>
    </Result>
  </Results>
</Response>

Service Level Response Fields

Output Name	Description
ErrorString	Lists error codes from any errors caused by the most recent request.
ResultCode	Lists result codes for the most recent request.
Results	Array containing the record level fields.
Version	The current service version number.

Record Level Response Fields

GrpDocInfo

See GrpDocInfo for service codes related to this group.

Output Name	Description
Address	Record array containing the returned address fields.
AddressKey	This is a country dependent field: US: This returns a 11 digit code representing the combination of the zip code, the plus4, and the delivery point. This is a fairly good representation of a unique US address and often used as the core of postal barcode. However, this code is not guaranteed to be unique to an individual address, please use the MelissaAddressKey instead for that purpose. It is possible that this field is empty or not 11 digits if the address is a Non-USPS address (link to something about non-usps addresses). GB: This field returns the UDPRN, which stands for Unique Delivery Point Reference Number. It is an 8 character code that is assigned and maintained by Royal Mail to each delivery point address. AU: This returns the DPID (Delivery Point ID). This is a 8 digit number that identifies a mailbox according to Australia Post.
AddressLine1
BaseMAK
City
CityAccepted
CityNotAccepted
CountrySubdivisionCode
MAK
PlusFour
PostalCode
State
SuiteCount
SuiteList
SuiteName

/jsonp/ExpressCityState, /web/ExpressCityState

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
Address Parameters
city	City, Locality, Municipality. The most common population center data element.
postalcode	Postal Code, ZIP. The complete postal code.
state	Administrative Area, Province, State. The most common geographic data element.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

/jsonp/ExpressPostalCode, /web/ExpressPostalCode

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
Address Parameters
postalcode	Postal Code, ZIP. The complete postal code.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

/jsonp/ExpressStreet, /web/ExpressStreet

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
Address Parameters
line1	The input field for the address, delimited by %20 or a space. This should contain the street address information (house number, thoroughfare, building, suite, etc.)
postalcode	Postal Code, ZIP. The complete postal code.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

/jsonp/GlobalExpressFreeForm, /web/GlobalExpressFreeForm

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
cols	Specifies which column(s) to be output as a comma delimited string. See Columns for more information.
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
nativecharset	True, False, or Blank. When set to True, return results in the native character set for the country. When set to False, return transliterated results in the Latin character set. When set to blank &nativecharset=, return results in the input character set.
opt	Set Options poboxes
Address Parameters
country	Default set to US. The ISO2Code or country name of the address.
ff	The free form address, with search terms delimited by %20 or a space.

Columns

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

Column	Returned Values
gbextras	GB Only. Return UPRN (SourceID) and UDPRN (SupplierID) values for each address. These will be in the Extras element.
results	US Only. Return Address Object result codes for each address in the Extras field. For example, a USPS only address will return "AddrObjectResultCode": "AS01".

Options

List options in the following format, with multiple options delimited with a ;.

OptionName:Parameter;OptionName:Parameter

poboxes

This options allows P.O. Boxes and military addresses to be returned with U.S. Addresses.

Parameter	Description
true	U.S. Addresses will return P.O. Boxes and military addresses.
false	P.O. Boxes and military addresses will not be returned.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

/jsonp/GlobalExpressAddress, /web/GlobalExpressAddress

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
cols	Specifies which column(s) to be output as a comma delimited string. See Columns for more information.
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
nativecharset	True, False, or Blank. When set to True, return results in the native character set for the country. When set to False, return transliterated results in the Latin character set. When set to blank &nativecharset=, return results in the input character set.
opt	Set Options poboxes
Address Parameters
address1	The input field for the address, delimited by %20 or a space. This should contain the street address information (house number, thoroughfare, building, suite, etc.)
address2	An additional field for extra address lines.
address3	An additional field for extra address lines.
administrativearea	Administrative Area, Province, State. The most common geographic data element.
country	Default set to US. The ISO2Code or country name of the address.
locality	City, Locality, Municipality. The most common population center data element.
postalcode	Postal Code, ZIP. The complete postal code.

Columns

Entering the column name will return the column. Specifying a group name will return all columns in the group.

Delimit multiple columns with a ,.

Column	Returned Values
gbextras	GB Only. Return UPRN (SourceID) and UDPRN (SupplierID) values for each address. These will be in the Extras element.
results	US Only. Return Address Object result codes for each address in the Extras field. For example, a USPS only address will return "AddrObjectResultCode": "AS01".

Options

List options in the following format, with multiple options delimited with a ;.

OptionName:Parameter;OptionName:Parameter

poboxes

This options allows P.O. Boxes and military addresses to be returned with U.S. Addresses.

Parameter	Description
true	U.S. Addresses will return P.O. Boxes and military addresses.
false	P.O. Boxes and military addresses will not be returned.

Headers

• GET JSONP
• GET JSON
• GET XML

Content-Type: application/javascript
Accept: application/javascript

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: application/xml

/jsonp/GlobalExpressLocalityAdministrativeArea, /web/GlobalExpressLocalityAdministrativeArea

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
nativecharset	True, False, or Blank. When set to True, return results in the native character set for the country. When set to False, return transliterated results in the Latin character set. When set to blank &nativecharset=, return results in the input character set.
Address Parameters
country	Default set to US. The ISO2Code or country name of the address.
locality	City, Locality, Municipality. The most common population center data element.
postalcode	Postal Code, ZIP. The complete postal code.

/jsonp/GlobalExpressPostalCode, /web/GlobalExpressPostalCode

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
Address Parameters
country	Default set to US. The ISO2Code or country name of the address.
postalcode	Postal Code, ZIP. The complete postal code.

/jsonp/GlobalExpressThoroughfare, /web/GlobalExpressThoroughfare

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
maxrecords	The maximum number of records to return. The default is 10 with a maximum of 100.
Address Parameters
country	Default set to US. The ISO2Code or country name of the address.
postalcode	Postal Code, ZIP. The complete postal code.
thoroughfare	Street, Thoroughfare. This is used to limit the search to thoroughfares beginning with the specified letters. This requires a minimum of three characters. For example, mai will return all thoroughfares beginning with mai in the specified postal code.

/jsonp/GlobalExpressCountry, /web/GlobalExpressCountry

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

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

Request Parameters

Code	Description
Record Level Parameters
format	Desired format of the response. Possible values are json, jsonp, or xml, depending on the endpoint.
id	The License Key issued by Melissa.
Address Parameters
country	The search term for the country/countries desired.

Token Server

• https://wiki.melissadata.com/index.php?title=Express_Entry:Token_Server

Dev Console

• https://devconsole.melissadata.com/globalexpressentry/

Result Codes

• https://wiki.melissadata.com/index.php?title=Express_Entry:Result_Codes

• https://wiki.melissadata.com/index.php?title=Result_Code_Details#Global_Express_Entry