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

{
  "d": {
    "__type": "Response",
    "Version": "8.0.0.1249",
    "ResultCode": "XS02",
    "ErrorString": "",
    "Results": [
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "9 Santa Agatha",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688-2427",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "92688242709",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            "2427"
          ],
          "MAK": "1279312453",
          "BaseMAK": ""
        }
      },
      ...
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "9 Floramar",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688-1307",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "92688130709",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            "1307"
          ],
          "MAK": "6148025901",
          "BaseMAK": ""
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS02",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "AddressLine1": "9 Santa Agatha",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688-2427",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "92688242709",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          "2427"
        ],
        "MAK": "1279312453",
        "BaseMAK": ""
      }
    },
    ...
    {
      "Address": {
        "AddressLine1": "9 Floramar",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688-1307",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "92688130709",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          "1307"
        ],
        "MAK": "6148025901",
        "BaseMAK": ""
      }
    }
  ]
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS02</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <Result>
      <Address>
        <AddressLine1>9 Santa Agatha</AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688-2427</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey>92688242709</AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string>2427</string>
        </PlusFour>
        <MAK>1279312453</MAK>
        <BaseMAK></BaseMAK>
      </Address>
    </Result>
    ...
    <Result>
      <Address>
        <AddressLine1>9 Floramar</AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688-1307</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey>92688130709</AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string>1307</string>
        </PlusFour>
        <MAK>6148025901</MAK>
        <BaseMAK></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

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	The first line of the address line.
BaseMAK	Melissa Address Key Base. If the address has suites or apartments the 10 digit proprietary BaseMAK will be returned and correspond to the overall building.
City	The city of the address.
CityAccepted	A list of accepted city names.
CityNotAccepted	Any non-accepted city names will be included in this field.
CountrySubdivisionCode	This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers.
MAK	Melissa Address Key. A unique key assigned to the submitted address.
PlusFour	The ZIP+4 portion of a ZIP Code.
PostalCode	Complete postal code for a particular delivery point.
State	The state of the address. The format is the 2 letter state code.
SuiteName	Returns the suite for the address in the AddressLine field, if any.
SuiteCount	The number of suites at the address.
SuiteList	A list of suites at the address.

/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

{
  "d": {
    "__type": "Response",
    "Version": "8.0.0.1249",
    "ResultCode": "XS02",
    "ErrorString": "",
    "Results": [
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "PO Box 80781",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688-0546",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "92688054646",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            "0546"
          ],
          "MAK": "4462720540",
          "BaseMAK": "1748370077"
        }
      },
      ...
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "1 Via Onagro",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688-4126",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "92688412601",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            "4126"
          ],
          "MAK": "1467463708",
          "BaseMAK": ""
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS02",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "AddressLine1": "PO Box 80781",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688-0546",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "92688054646",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          "0546"
        ],
        "MAK": "4462720540",
        "BaseMAK": "1748370077"
      }
    },
    ...
    {
      "Address": {
        "AddressLine1": "1 Via Onagro",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688-4126",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "92688412601",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          "4126"
        ],
        "MAK": "1467463708",
        "BaseMAK": ""
      }
    }
  ]
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS02</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <Result>
      <Address>
        <AddressLine1>PO Box 80781</AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688-0546</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey>92688054646</AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string>0546</string>
        </PlusFour>
        <MAK>4462720540</MAK>
        <BaseMAK>1748370077</BaseMAK>
      </Address>
    </Result>
    ...
    <Result>
      <Address>
        <AddressLine1>1 Via Onagro</AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688-4126</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey>92688412601</AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string>4126</string>
        </PlusFour>
        <MAK>1467463708</MAK>
        <BaseMAK></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

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	The first line of the address line.
BaseMAK	Melissa Address Key Base. If the address has suites or apartments the 10 digit proprietary BaseMAK will be returned and correspond to the overall building.
City	The city of the address.
CityAccepted	The accepted city value.
CityNotAccepted	The non-accepted city value.
CountrySubdivisionCode	This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 or 3 characters or two numbers.
MAK	Melissa Address Key. A unique key assigned to the submitted address.
PlusFour	The ZIP+4 portion of a ZIP Code.
PostalCode	Complete postal code for a particular delivery point.
State	The state of the address. The format is the 2 letter state code.
SuiteCount	The number of suites at the address.
SuiteList	A list of suites at the address.
SuiteName	Returns the suite for the address in the AddressLine field, if any.

/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

Response

• GET JSONP
• GET JSON
• GET XML

{
  "d": {
    "__type": "Response",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            ""
          ],
          "MAK": "",
          "BaseMAK": ""
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "AddressLine1": "",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          ""
        ],
        "MAK": "",
        "BaseMAK": ""
      }
    }
  ]
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <Result>
      <Address>
        <AddressLine1></AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey></AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string></string>
        </PlusFour>
        <MAK></MAK>
        <BaseMAK></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.

/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

Response

• GET JSONP
• GET JSON
• GET XML

{
  "d": {
    "__type": "Response",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "Result",
        "Address": {
          "__type": "Address",
          "AddressLine1": "",
          "City": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "State": "CA",
          "PostalCode": "92688",
          "CountrySubdivisionCode": "US-CA",
          "AddressKey": "",
          "SuiteName": "",
          "SuiteCount": 0,
          "SuiteList": [
            ""
          ],
          "PlusFour": [
            ""
          ],
          "MAK": "",
          "BaseMAK": ""
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "AddressLine1": "",
        "City": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "State": "CA",
        "PostalCode": "92688",
        "CountrySubdivisionCode": "US-CA",
        "AddressKey": "",
        "SuiteName": "",
        "SuiteCount": 0,
        "SuiteList": [
          ""
        ],
        "PlusFour": [
          ""
        ],
        "MAK": "",
        "BaseMAK": ""
      }
    }
  ]
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <Result>
      <Address>
        <AddressLine1></AddressLine1>
        <City>Rancho Santa Margarita</City>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <State>CA</State>
        <PostalCode>92688</PostalCode>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <AddressKey></AddressKey>
        <SuiteName></SuiteName>
        <SuiteCount>0</SuiteCount>
        <SuiteList>
          <string></string>
        </SuiteList>
        <PlusFour>
          <string></string>
        </PlusFour>
        <MAK></MAK>
        <BaseMAK></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.

/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

Response

• GET JSONP
• GET JSON
• GET XML

{
  "d": {
    "__type": "Response",
    "Version": "8.0.0.1249",
    "ResultCode": "XS03",
    "ErrorString": "no results found",
    "Results": []
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS03",
  "ErrorString": "no results found",
  "Results": []
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS03</ResultCode>
  <ErrorString>no results found</ErrorString>
  <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.

/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

Response

• GET JSONP
• GET JSON
• GET XML

{
  "d": {
    "__type": "ResponseGlobal",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "Address": "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688-2112",
          "Address1": "22382 Avenida Empresa",
          "Address2": "Rancho Santa Margarita, CA 92688-2112",
          "Address3": "",
          "Address4": "",
          "Address5": "",
          "Address6": "",
          "Address7": "",
          "Address8": "",
          "Address9": "",
          "Address10": "",
          "Address11": "",
          "Address12": "",
          "DeliveryAddress": "22382 Avenida Empresa",
          "DeliveryAddress1": "22382 Avenida Empresa",
          "DeliveryAddress2": "",
          "DeliveryAddress3": "",
          "DeliveryAddress4": "",
          "DeliveryAddress5": "",
          "DeliveryAddress6": "",
          "DeliveryAddress7": "",
          "DeliveryAddress8": "",
          "DeliveryAddress9": "",
          "DeliveryAddress10": "",
          "DeliveryAddress11": "",
          "DeliveryAddress12": "",
          "CountryName": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "Orange",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "Avenida Empresa",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "22382",
          "SubBuilding": "",
          "PostalCode": "92688-2112",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "2112",
          "Organization": "",
          "PostBox": "",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "8008006245",
          "BaseMAK": "",
          "Latitude": "33.637562",
          "Longitude": "-117.606887",
          "DistanceFromPoint": 0
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "Address": "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688-2112",
        "Address1": "22382 Avenida Empresa",
        "Address2": "Rancho Santa Margarita, CA 92688-2112",
        "Address3": "",
        "Address4": "",
        "Address5": "",
        "Address6": "",
        "Address7": "",
        "Address8": "",
        "Address9": "",
        "Address10": "",
        "Address11": "",
        "Address12": "",
        "DeliveryAddress": "22382 Avenida Empresa",
        "DeliveryAddress1": "22382 Avenida Empresa",
        "DeliveryAddress2": "",
        "DeliveryAddress3": "",
        "DeliveryAddress4": "",
        "DeliveryAddress5": "",
        "DeliveryAddress6": "",
        "DeliveryAddress7": "",
        "DeliveryAddress8": "",
        "DeliveryAddress9": "",
        "DeliveryAddress10": "",
        "DeliveryAddress11": "",
        "DeliveryAddress12": "",
        "CountryName": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "Orange",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "Avenida Empresa",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "22382",
        "SubBuilding": "",
        "PostalCode": "92688-2112",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "2112",
        "Organization": "",
        "PostBox": "",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "8008006245",
        "BaseMAK": "",
        "Latitude": "33.637562",
        "Longitude": "-117.606887",
        "DistanceFromPoint": 0
      }
    }
  ]
}

<ResponseGlobal
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <ResultGlobal>
      <Address>
        <Address>22382 Avenida Empresa, Rancho Santa Margarita, CA 92688-2112</Address>
        <Address1>22382 Avenida Empresa</Address1>
        <Address2>Rancho Santa Margarita, CA 92688-2112</Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress>22382 Avenida Empresa</DeliveryAddress>
        <DeliveryAddress1>22382 Avenida Empresa</DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>Orange</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare>Avenida Empresa</Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise>22382</Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688-2112</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary>2112</PostalCodeSecondary>
        <Organization></Organization>
        <PostBox></PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK>8008006245</MAK>
        <BaseMAK></BaseMAK>
        <Latitude>33.637562</Latitude>
        <Longitude>-117.606887</Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
  </Results>
</ResponseGlobal>

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.

/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

Response

• GET JSONP
• GET JSON
• GET XML

{
  "d": {
    "__type": "ResponseGlobal",
    "Version": "8.0.0.1249",
    "ResultCode": "XS02",
    "ErrorString": "",
    "Results": [
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "Address": "PO Box 80781, Rancho Santa Margarita, CA 92688-0546",
          "Address1": "PO Box 80781",
          "Address2": "Rancho Santa Margarita, CA 92688-0546",
          "Address3": "",
          "Address4": "",
          "Address5": "",
          "Address6": "",
          "Address7": "",
          "Address8": "",
          "Address9": "",
          "Address10": "",
          "Address11": "",
          "Address12": "",
          "DeliveryAddress": "PO Box 80781",
          "DeliveryAddress1": "PO Box 80781",
          "DeliveryAddress2": "",
          "DeliveryAddress3": "",
          "DeliveryAddress4": "",
          "DeliveryAddress5": "",
          "DeliveryAddress6": "",
          "DeliveryAddress7": "",
          "DeliveryAddress8": "",
          "DeliveryAddress9": "",
          "DeliveryAddress10": "",
          "DeliveryAddress11": "",
          "DeliveryAddress12": "",
          "CountryName": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "Orange",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "",
          "SubBuilding": "",
          "PostalCode": "92688-0546",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "0546",
          "Organization": "",
          "PostBox": "PO Box 80781",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "4462720540",
          "BaseMAK": "1748370077",
          "Latitude": "33.636760",
          "Longitude": "-117.609379",
          "DistanceFromPoint": 0
        }
      },
      ...
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "Address": "1 Via Onagro, Rancho Santa Margarita, CA 92688-4126",
          "Address1": "1 Via Onagro",
          "Address2": "Rancho Santa Margarita, CA 92688-4126",
          "Address3": "",
          "Address4": "",
          "Address5": "",
          "Address6": "",
          "Address7": "",
          "Address8": "",
          "Address9": "",
          "Address10": "",
          "Address11": "",
          "Address12": "",
          "DeliveryAddress": "1 Via Onagro",
          "DeliveryAddress1": "1 Via Onagro",
          "DeliveryAddress2": "",
          "DeliveryAddress3": "",
          "DeliveryAddress4": "",
          "DeliveryAddress5": "",
          "DeliveryAddress6": "",
          "DeliveryAddress7": "",
          "DeliveryAddress8": "",
          "DeliveryAddress9": "",
          "DeliveryAddress10": "",
          "DeliveryAddress11": "",
          "DeliveryAddress12": "",
          "CountryName": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "Orange",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "Via Onagro",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "1",
          "SubBuilding": "",
          "PostalCode": "92688-4126",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "4126",
          "Organization": "",
          "PostBox": "",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "1467463708",
          "BaseMAK": "",
          "Latitude": "33.647046",
          "Longitude": "-117.615252",
          "DistanceFromPoint": 0
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS02",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "Address": "PO Box 80781, Rancho Santa Margarita, CA 92688-0546",
        "Address1": "PO Box 80781",
        "Address2": "Rancho Santa Margarita, CA 92688-0546",
        "Address3": "",
        "Address4": "",
        "Address5": "",
        "Address6": "",
        "Address7": "",
        "Address8": "",
        "Address9": "",
        "Address10": "",
        "Address11": "",
        "Address12": "",
        "DeliveryAddress": "PO Box 80781",
        "DeliveryAddress1": "PO Box 80781",
        "DeliveryAddress2": "",
        "DeliveryAddress3": "",
        "DeliveryAddress4": "",
        "DeliveryAddress5": "",
        "DeliveryAddress6": "",
        "DeliveryAddress7": "",
        "DeliveryAddress8": "",
        "DeliveryAddress9": "",
        "DeliveryAddress10": "",
        "DeliveryAddress11": "",
        "DeliveryAddress12": "",
        "CountryName": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "Orange",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "",
        "SubBuilding": "",
        "PostalCode": "92688-0546",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "0546",
        "Organization": "",
        "PostBox": "PO Box 80781",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "4462720540",
        "BaseMAK": "1748370077",
        "Latitude": "33.636760",
        "Longitude": "-117.609379",
        "DistanceFromPoint": 0
      }
    },
    ...
    {
      "Address": {
        "Address": "1 Via Onagro, Rancho Santa Margarita, CA 92688-4126",
        "Address1": "1 Via Onagro",
        "Address2": "Rancho Santa Margarita, CA 92688-4126",
        "Address3": "",
        "Address4": "",
        "Address5": "",
        "Address6": "",
        "Address7": "",
        "Address8": "",
        "Address9": "",
        "Address10": "",
        "Address11": "",
        "Address12": "",
        "DeliveryAddress": "1 Via Onagro",
        "DeliveryAddress1": "1 Via Onagro",
        "DeliveryAddress2": "",
        "DeliveryAddress3": "",
        "DeliveryAddress4": "",
        "DeliveryAddress5": "",
        "DeliveryAddress6": "",
        "DeliveryAddress7": "",
        "DeliveryAddress8": "",
        "DeliveryAddress9": "",
        "DeliveryAddress10": "",
        "DeliveryAddress11": "",
        "DeliveryAddress12": "",
        "CountryName": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "Orange",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "Via Onagro",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "1",
        "SubBuilding": "",
        "PostalCode": "92688-4126",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "4126",
        "Organization": "",
        "PostBox": "",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "1467463708",
        "BaseMAK": "",
        "Latitude": "33.647046",
        "Longitude": "-117.615252",
        "DistanceFromPoint": 0
      }
    }
  ]
}

<ResponseGlobal
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS02</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <ResultGlobal>
      <Address>
        <Address>PO Box 80781, Rancho Santa Margarita, CA 92688-0546</Address>
        <Address1>PO Box 80781</Address1>
        <Address2>Rancho Santa Margarita, CA 92688-0546</Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress>PO Box 80781</DeliveryAddress>
        <DeliveryAddress1>PO Box 80781</DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>Orange</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare></Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise></Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688-0546</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary>0546</PostalCodeSecondary>
        <Organization></Organization>
        <PostBox>PO Box 80781</PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK>4462720540</MAK>
        <BaseMAK>1748370077</BaseMAK>
        <Latitude>33.636760</Latitude>
        <Longitude>-117.609379</Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
    ...
    <ResultGlobal>
      <Address>
        <Address>1 Via Onagro, Rancho Santa Margarita, CA 92688-4126</Address>
        <Address1>1 Via Onagro</Address1>
        <Address2>Rancho Santa Margarita, CA 92688-4126</Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress>1 Via Onagro</DeliveryAddress>
        <DeliveryAddress1>1 Via Onagro</DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>Orange</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare>Via Onagro</Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise>1</Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688-4126</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary>4126</PostalCodeSecondary>
        <Organization></Organization>
        <PostBox></PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK>1467463708</MAK>
        <BaseMAK></BaseMAK>
        <Latitude>33.647046</Latitude>
        <Longitude>-117.615252</Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
  </Results>
</ResponseGlobal>

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.

/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.

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

{
  "d": {
    "__type": "ResponseGlobal",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "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": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "Orange",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "",
          "SubBuilding": "",
          "PostalCode": "92688",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "",
          "Organization": "",
          "PostBox": "",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "",
          "BaseMAK": "",
          "Latitude": "",
          "Longitude": "",
          "DistanceFromPoint": 0
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "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": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "Orange",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "",
        "SubBuilding": "",
        "PostalCode": "92688",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "",
        "Organization": "",
        "PostBox": "",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "",
        "BaseMAK": "",
        "Latitude": "",
        "Longitude": "",
        "DistanceFromPoint": 0
      }
    }
  ]
}

<ResponseGlobal
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <ResultGlobal>
      <Address>
        <Address></Address>
        <Address1></Address1>
        <Address2></Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress></DeliveryAddress>
        <DeliveryAddress1></DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>Orange</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare></Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise></Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary></PostalCodeSecondary>
        <Organization></Organization>
        <PostBox></PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK></MAK>
        <BaseMAK></BaseMAK>
        <Latitude></Latitude>
        <Longitude></Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
  </Results>
</ResponseGlobal>

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.

/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.

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

{
  "d": {
    "__type": "ResponseGlobal",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "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": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "Orange",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "",
          "SubBuilding": "",
          "PostalCode": "92688",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "",
          "Organization": "",
          "PostBox": "",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "",
          "BaseMAK": "",
          "Latitude": "",
          "Longitude": "",
          "DistanceFromPoint": 0
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "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": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "Orange",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "",
        "SubBuilding": "",
        "PostalCode": "92688",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "",
        "Organization": "",
        "PostBox": "",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "",
        "BaseMAK": "",
        "Latitude": "",
        "Longitude": "",
        "DistanceFromPoint": 0
      }
    }
  ]
}

<ResponseGlobal
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <ResultGlobal>
      <Address>
        <Address></Address>
        <Address1></Address1>
        <Address2></Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress></DeliveryAddress>
        <DeliveryAddress1></DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>Orange</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare></Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise></Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary></PostalCodeSecondary>
        <Organization></Organization>
        <PostBox></PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK></MAK>
        <BaseMAK></BaseMAK>
        <Latitude></Latitude>
        <Longitude></Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
  </Results>
</ResponseGlobal>

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.

/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.

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

{
  "d": {
    "__type": "ResponseGlobal",
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "__type": "ResultGlobal",
        "Address": {
          "__type": "AddressGlobal",
          "Address": "",
          "Address1": "Avenida Empresa",
          "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": "United States Of America",
          "ISO3166_2": "US",
          "ISO3166_3": "USA",
          "ISO3166_N": "840",
          "SuperAdministrativeArea": "",
          "AdministrativeArea": "CA",
          "SubAdministrativeArea": "CA",
          "Locality": "Rancho Santa Margarita",
          "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
          "CityNotAccepted": "",
          "DependentLocality": "",
          "DoubleDependentLocality": "",
          "Thoroughfare": "Avenida Empresa",
          "DependentThoroughfare": "",
          "Building": "",
          "Premise": "",
          "SubBuilding": "",
          "PostalCode": "92688",
          "PostalCodePrimary": "92688",
          "PostalCodeSecondary": "",
          "Organization": "",
          "PostBox": "",
          "Unmatched": "",
          "GeneralDelivery": "",
          "DeliveryInstallation": "",
          "Route": "",
          "AdditionalContent": "",
          "CountrySubdivisionCode": "US-CA",
          "MAK": "",
          "BaseMAK": "",
          "Latitude": "",
          "Longitude": "",
          "DistanceFromPoint": 0
        }
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Address": {
        "Address": "",
        "Address1": "Avenida Empresa",
        "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": "United States Of America",
        "ISO3166_2": "US",
        "ISO3166_3": "USA",
        "ISO3166_N": "840",
        "SuperAdministrativeArea": "",
        "AdministrativeArea": "CA",
        "SubAdministrativeArea": "CA",
        "Locality": "Rancho Santa Margarita",
        "CityAccepted": "Rancho Sta Marg,Rsm,Rcho Sta Marg",
        "CityNotAccepted": "",
        "DependentLocality": "",
        "DoubleDependentLocality": "",
        "Thoroughfare": "Avenida Empresa",
        "DependentThoroughfare": "",
        "Building": "",
        "Premise": "",
        "SubBuilding": "",
        "PostalCode": "92688",
        "PostalCodePrimary": "92688",
        "PostalCodeSecondary": "",
        "Organization": "",
        "PostBox": "",
        "Unmatched": "",
        "GeneralDelivery": "",
        "DeliveryInstallation": "",
        "Route": "",
        "AdditionalContent": "",
        "CountrySubdivisionCode": "US-CA",
        "MAK": "",
        "BaseMAK": "",
        "Latitude": "",
        "Longitude": "",
        "DistanceFromPoint": 0
      }
    }
  ]
}

<ResponseGlobal
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <ResultGlobal>
      <Address>
        <Address></Address>
        <Address1>Avenida Empresa</Address1>
        <Address2></Address2>
        <Address3></Address3>
        <Address4></Address4>
        <Address5></Address5>
        <Address6></Address6>
        <Address7></Address7>
        <Address8></Address8>
        <Address9></Address9>
        <Address10></Address10>
        <Address11></Address11>
        <Address12></Address12>
        <DeliveryAddress></DeliveryAddress>
        <DeliveryAddress1></DeliveryAddress1>
        <DeliveryAddress2></DeliveryAddress2>
        <DeliveryAddress3></DeliveryAddress3>
        <DeliveryAddress4></DeliveryAddress4>
        <DeliveryAddress5></DeliveryAddress5>
        <DeliveryAddress6></DeliveryAddress6>
        <DeliveryAddress7></DeliveryAddress7>
        <DeliveryAddress8></DeliveryAddress8>
        <DeliveryAddress9></DeliveryAddress9>
        <DeliveryAddress10></DeliveryAddress10>
        <DeliveryAddress11></DeliveryAddress11>
        <DeliveryAddress12></DeliveryAddress12>
        <CountryName>United States Of America</CountryName>
        <ISO3166_2>US</ISO3166_2>
        <ISO3166_3>USA</ISO3166_3>
        <ISO3166_N>840</ISO3166_N>
        <SuperAdministrativeArea></SuperAdministrativeArea>
        <AdministrativeArea>CA</AdministrativeArea>
        <SubAdministrativeArea>CA</SubAdministrativeArea>
        <Locality>Rancho Santa Margarita</Locality>
        <CityAccepted>Rancho Sta Marg,Rsm,Rcho Sta Marg</CityAccepted>
        <CityNotAccepted></CityNotAccepted>
        <DependentLocality></DependentLocality>
        <DoubleDependentLocality></DoubleDependentLocality>
        <Thoroughfare>Avenida Empresa</Thoroughfare>
        <DependentThoroughfare></DependentThoroughfare>
        <Building></Building>
        <Premise></Premise>
        <SubBuilding></SubBuilding>
        <PostalCode>92688</PostalCode>
        <PostalCodePrimary>92688</PostalCodePrimary>
        <PostalCodeSecondary></PostalCodeSecondary>
        <Organization></Organization>
        <PostBox></PostBox>
        <Unmatched></Unmatched>
        <GeneralDelivery></GeneralDelivery>
        <DeliveryInstallation></DeliveryInstallation>
        <Route></Route>
        <AdditionalContent></AdditionalContent>
        <CountrySubdivisionCode>US-CA</CountrySubdivisionCode>
        <MAK></MAK>
        <BaseMAK></BaseMAK>
        <Latitude></Latitude>
        <Longitude></Longitude>
        <DistanceFromPoint>0</DistanceFromPoint>
      </Address>
    </ResultGlobal>
  </Results>
</ResponseGlobal>

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.

/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.

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

{
  "d": {
    "Version": "8.0.0.1249",
    "ResultCode": "XS01",
    "ErrorString": "",
    "Results": [
      {
        "Country": "Usbekistan",
        "English": "Uzbekistan",
        "Spanish": "Uzbekistán",
        "French": "Ouzbékistan",
        "German": "Usbekistan",
        "SimplifiedChinese": "乌兹别克斯坦 ",
        "Char2ISO": "UZ",
        "Char3ISO": "UZB",
        "ISONumeric": "860"
      },
      ...
      {
        "Country": "Tierras Australes y Antárticas Francesas",
        "English": "French Southern Territories",
        "Spanish": "Tierras Australes y Antárticas Francesas",
        "French": "Terres Australes Françaises",
        "German": "Französische Süd- und Antarktisgebiete",
        "SimplifiedChinese": "法属南部领土",
        "Char2ISO": "TF",
        "Char3ISO": "ATF",
        "ISONumeric": "260"
      }
    ]
  }
}

{
  "Version": "8.0.0.1249",
  "ResultCode": "XS01",
  "ErrorString": "",
  "Results": [
    {
      "Country": "Usbekistan",
      "English": "Uzbekistan",
      "Spanish": "Uzbekistán",
      "French": "Ouzbékistan",
      "German": "Usbekistan",
      "SimplifiedChinese": "乌兹别克斯坦 ",
      "Char2ISO": "UZ",
      "Char3ISO": "UZB",
      "ISONumeric": "860"
    },
    ...
    {
      "Country": "Tierras Australes y Antárticas Francesas",
      "English": "French Southern Territories",
      "Spanish": "Tierras Australes y Antárticas Francesas",
      "French": "Terres Australes Françaises",
      "German": "Französische Süd- und Antarktisgebiete",
      "SimplifiedChinese": "法属南部领土",
      "Char2ISO": "TF",
      "Char3ISO": "ATF",
      "ISONumeric": "260"
    }
  ]
}

<Response
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Version>8.0.0.1249</Version>
  <ResultCode>XS01</ResultCode>
  <ErrorString></ErrorString>
  <Results>
    <Result>
      <Country>Usbekistan</Country>
      <English>Uzbekistan</English>
      <Spanish>Uzbekistán</Spanish>
      <French>Ouzbékistan</French>
      <German>Usbekistan</German>
      <SimplifiedChinese>乌兹别克斯坦 </SimplifiedChinese>
      <Char2ISO>UZ</Char2ISO>
      <Char3ISO>UZB</Char3ISO>
      <ISONumeric>860</ISONumeric>
    </Result>
    ...
    <Result>
      <Country>Tierras Australes y Antárticas Francesas</Country>
      <English>French Southern Territories</English>
      <Spanish>Tierras Australes y Antárticas Francesas</Spanish>
      <French>Terres Australes Françaises</French>
      <German>Französische Süd- und Antarktisgebiete</German>
      <SimplifiedChinese>法属南部领土</SimplifiedChinese>
      <Char2ISO>TF</Char2ISO>
      <Char3ISO>ATF</Char3ISO>
      <ISONumeric>260</ISONumeric>
    </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.

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