Express Entry:GlobalExpressAddress

← Global Express Entry

URL

REST

Use	URL
Standard	http://expressentry.melissadata.net/web/GlobalExpressAddress
Secure	https://expressentry.melissadata.net/web/GlobalExpressAddress

JSON

Use	URL
Standard	http://expressentry.melissadata.net/jsonp/GlobalExpressAddress
Secure	https://expressentry.melissadata.net/jsonp/GlobalExpressAddress

GlobalExpressAddress

The GlobalExpressAddress service is consumed to retrieve results containing all of the available address elements of an address record: FormattedAddress, AddressLine1-8, CountryISO3166_1_Alpha2, CountryISO3166_1_Alpha3, CountryISO3166_1_Numeric, SubNationalArea, PremisesNumber, AdministrativeArea, SubadministrativeArea, locality, dependentlocality, doubledependentlocality, thoroughfare, dependentthoroughfare, building, postalcode, and postbox.

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

Example Call

http://expressentry.melissadata.net/web/GlobalExpressAddress?format={FORMAT}&id={ID}&address1={ADDRESS1}&locality={LOCALITY}&administrativearea={ADMINISTRATIVEAREA}&postalcode={POSTALCODE}&country={COUNTRY}&maxrecords={MAXRECORDS}&nativecharset={True|False|(blank)}&opt={poboxes:true}&cols={gbextras,results}

Requested Field	Input	Description
Format	{XML, JSON}	The return format of the request.
ID	Text	The License Key or token
Address1	Search terms delimited by %20 or space.	The actual words of the search term.
Locality	Text	Optional. The locality of the address.
AdministrativeArea	Text	Optional. The administrative area of the address.
PostalCode	Text	Optional. The postal code of the address.
Country	Text	The ISO2Code or country name of the address (required, Default US).
Maxrecords	Number	The maximum number of records to return (required). (Default 10, Maximum 100)
Nativecharset	True/False/Blank	Optional. Return results in the native character set for the country.
Opt	poboxes:true	US Only: Return P.O. Boxes and military addresses
Cols	gbextras	GB Only: Return UPRN (SourceID) and UDPRN (SupplierID) values for each address.
	results	US Only: Return AS## result codes (see Result Code Details.)

Schema

?format=

The response will be formatted according to the value set here.

Valid values are: XML and JSON.

&id=

The ID element can contain your user ID, a complete License Key, or a token.

&address1-3=

Address1-3 can be used in combination with Locality, Administrative Area, or PostalCode.

&locality=

Using the Locality in a query will help refine results, limiting responses accordingly.

&administrativearea=

Using the Administrative Area in a query will help refine results, limiting responses accordingly.

&postalcode=

Using the postal code in a query will help refine results, limiting responses accordingly.

&country=

The ISO2Code or full country name of the country to search (Required, Default US).

&maxrecords=

Maxrecords is provided to control the number of results returned from a request to the service (Required).

The default value is 10 and the maximum is 100 records.

&nativecharset=

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=

• When set to poboxes:true, U.S. Addresses will return P.O. Boxes and military addresses along with the usual address results. Multiple options for &opt can be delimited by semicolon.

&cols=

• When set to gbextras this will return UPRN and UDPRN values for each address. These will be in the Extras element.
• (U.S. Only) When set to results this will return the Address and GeoCoding Result Codes for each address in the Extras field. For example, a USPS only address with a rooftop geocode will return "AddrObjectResultCode": "AS01,GS05". You can see a full list of the Address and GeoCoding result codes and their definitions here: Global Express Entry Result Code Details.

Extras

If you specify &cols=gbextras in the request options, we will return additional outputs. These outputs are presented in a different format. They will look like this below.

<Extras>
    <root>
        <extra>
            <key>UDPRN</key>
            <value>25877698</value>
        </extra>
        <extra>
            <key>UPRN</key>
            <value>217122173</value>
        </extra>
    </root>
</Extras>

Here are the possible output and groups:

Output Name	Description
UDPRN	The Unique Delivery Point Reference Number issued by Royal Mail. This is an 8-digit unique number.
UPRN	The Unique Property Reference Number issued by Royal Mail. This is a number unique to each address in GB. This is a unique number up to 12-digits long.