Reference Guide#

Introduction #

Global Address Container ensures accurate and complete mailing addresses worldwide. Supporting address verification and correction across more than 240 countries and territories, it provides users with standardized, reliable address data to streamline delivery processes.

Beyond its robust verification capabilities, the service can append geographic coordinates, region-specific identifiers, and delivery indicators. It also provides parsed address components and returns delivery addresses in mailing label formats that comply with the postal standards of each country.

As a self-hosted container, Global Address Container is deployed and managed on-premises, giving you complete control over your data, security, and performance. Self-hosting ensures compliance with data sovereignty requirements while providing better performance for low-latency or high-volume workloads.

Data Path #

This is configured during the containerization service set-up and represents the location of the data files on your local machine.

See {{data_path}} in the Example Docker Setup.

Service Port Number #

This is configured during the containerization service set-up. It defaults to 6245, but can be any port you set.

See {{port_number}} in the Example Docker Setup.

Machine Name #

This is your local machine name and will be used in every request you send to your local containerization service. You can view your machine name by using the hostname command in the command prompt.

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 the service will not function.

Endpoints #

/V3/WEB/GlobalAddress/GetVersion #

Introduction #

Use this endpoint to check the version of Global Address Container.

Try It Now #

GET JSON

curl -X GET \
"http://{{machine_name}}:{{port_number}}/V3/WEB/GlobalAddress/GetVersion" \
-H "Accept: application/json"

Headers #

GET JSON

Cache-Control: no-cache,no-store,must-revalidate,private
Content-Type: application/json; charset=utf-8
Pragma: no-cache

Response #

GET JSON

{
  "Version_0": "8.4.1.7039",
  "ServiceName_0": "globalAddrLibService",
  "BuildNumber_0": "7228",
  "DatabaseDate_0": "2024-11-26",
  "ExpirationDate_0": "2025-02-26",
  "LicenseExpirationDate_0": "2050-01-04",
  "AddrBuildNumber_0": "17973",
  "AddrDatabaseDate_0": "2024-11-01",
  "GeoBuildNumber_0": "17426",
  "GeoDatabaseDate_0": "2024-10-15",
  "RightFielderBuildNumber_0": "4046",
  "RightFielderDatabaseDate_0": "2024-01-23",
  "Version_1": "8.4.1.7039",
  "ServiceName_1": "globalAddrLibService",
  "BuildNumber_1": "7228",
  "DatabaseDate_1": "2024-11-26",
  "ExpirationDate_1": "2025-02-26",
  "LicenseExpirationDate_1": "2050-01-04",
  "AddrBuildNumber_1": "17973",
  "AddrDatabaseDate_1": "2024-11-01",
  "GeoBuildNumber_1": "17426",
  "GeoDatabaseDate_1": "2024-10-15",
  "RightFielderBuildNumber_1": "4046",
  "RightFielderDatabaseDate_1": "2024-01-23"
}

/V3/WEB/GlobalAddress/doGlobalAddress #

Introduction #

Use this endpoint to utilize all of the international address verification capabilities of Global Address Object.

Try It Now #

GET JSON
POST JSON

curl -X GET \
"http://{{machine_name}}:{{port_number}}/V3/WEB/GlobalAddress/doGlobalAddress?\
&t=Test\
&org=Melissa\
&a1=22382%20Avenida%20Empresa\
&loc=Rancho%20Santa%20Margarita\
&admarea=CA\
&postal=92688\
&ctry=US\
&format=JSON" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X POST \
  "http://{{machine_name}}:{{port_number}}/V3/WEB/GlobalAddress/doGlobalAddress" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
   "TransmissionReference": "Test",
   "Records": [
     {
       "RecordID": "1",
       "Organization": "Melissa",
       "AddressLine1": "22382 Avenida Empresa",
       "Locality": "Rancho Santa Margarita",
       "AdministrativeArea": "CA",
       "PostalCode": "92688",
       "Country": "US"
     }
  ]
}'

Request Parameters #

GET JSON
POST JSON

Code

Description

Request Level Parameters

format

Optional. Specify the desired format of the response.

opt

Set Options
ExtendedDateTime
GBExtras
LineSeparator
OriginDateTime
OutputPreference

t

Optional. This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Record Level Parameters

a1

Required. The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.

a2

Optional. The input field for the address.

a3

Optional. The input field for the address.

a4

Optional. The input field for the address.

a5

Optional. The input field for the address.

a6

Optional. The input field for the address.

a7

Optional. The input field for the address.

a8

Optional. The input field for the address.

admarea

Required. State, Province. The most common geographic data element.

ctry

Required. The country name, abbreviation, or code.

deploc

Optional. Urbanization. The smaller population center data element. This depends on the Locality element. In terms of US Addresses, this element applies only to Puerto Rican addresses. It is used to break ties when a ZIP Code™ is linked to multiple instances of the same address.

ddeploc

Optional. The smallest population center data element. This depends on the Locality and DependentLocality elements.

last

Optional. US Only. For addresses missing a secondary like a suite or apartment, we can use the last name and append that information for residential addresses.

loc

Required. City, Municipality. The most common population center data element.

org

Optional. The organization name associated with the address record.

postal

Required. ZIP, Postcode. The complete postal code for a particular delivery point. If all three elements are provided and the PostalCode is incorrect, it can be corrected from the data on the Locality and AdministrativeArea.

subadmarea

Optional. County. The smallest geographic data element.

subnatarea

Optional. The administrative region within a country on an arbitrary level below that of the sovereign state.

Code

Description

Request Level Parameters

Format

Optional. Specify the desired format of the response.

Options

Set Options
ExtendedDateTime
GBExtras
LineSeparator
OriginDateTime
OutputPreference

TransmissionReference

Optional. This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Record Level Parameters

AddressLine1

AddressLine2

Optional. The input field for the address.

AddressLine3

Optional. The input field for the address.

AddressLine4

Optional. The input field for the address.

AddressLine5

Optional. The input field for the address.

AddressLine6

Optional. The input field for the address.

AddressLine7

Optional. The input field for the address.

AddressLine8

Optional. The input field for the address.

AdministrativeArea

Required. State, Province. The most common geographic data element.

Country

Required. The country name, abbreviation, or code.

DependentLocality

DoubleDependentLocality

Optional. The smallest population center data element. This depends on the Locality and DependentLocality elements.

LastName

Optional. US Only. For addresses missing a secondary like a suite or apartment, we can use the last name and append that information for residential addresses.

Locality

Required. City, Municipality. The most common population center data element.

Organization

Optional. The organization name associated with the address record.

PostalCode

SubAdministrativeArea

Optional. County. The smallest geographic data element.

SubNationalArea

Optional. The administrative region within a country on an arbitrary level below that of the sovereign state.

Options #

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

OptionName:Parameter,OptionName:Parameter

ExtendedDateTime #

Additional information related to time zone names and UTC information for both standard and daylight savings will be made available in the Extras section. Please see the Extras section for additional details.

Parameter	Description
`Off`	Default. No additional output information is provided.
`On`	Additional time zone and UTC information will be made available in the Extras section.

GBExtras #

Allows you to choose to add the UPRN output.

Parameter	Description
`Off`	Default. No additional output information is provided.
`On`	Adds the additional output value of UPRN. Please see the Extras section for additional details.

LineSeparator #

This is the line separator used for the FormattedAddress result.

Parameter	Description
`SEMICOLON`	Default. A semicolon (`;`).
`PIPE`	A pipe (`\|`).
`CR`	A carriage return.
`LF`	A line feed.
`CRLF`	A carriage return + line feed.
`TAB`	A tab.
`BR`	A line break.

OriginDateTime (BETA)#

A string DateTime value with UTC data to use in the calculation of the local date time.

This feature will allow you to convert the origin time into the local time at the output address. This calculation takes into account the difference in UTC from the origin to the output address and also takes into account the dates that daylight savings is observed at the destination.

For example: OriginDateTime:2022-01-13 18:33:16 (UTC-8:00). Note, we need the UTC value to know exactly where the origin time is from. If you do not specify a UTC value, we will assume a UTC value of 0.

Parameter	Description
`[String]`	String DateTime value with UTC data to use in the calculation of the local date time.

OutputPreference #

This is the script type used for all applicable fields.

Parameter	Description
`NOCHANGE`	Default. Returns the same script that is sent in.
`LATIN`	Returns in the Latin script.
`NATIVE`	Returns in the native script for the designated country.

Headers #

GET JSON
POST JSON

Cache-Control: no-cache,no-store,must-revalidate,private
Content-Type: application/json; charset=utf-8
Pragma: no-cache

Cache-Control: no-cache,no-store,must-revalidate,private
Content-Type: application/json; charset=utf-8
Pragma: no-cache

Response #

GET JSON
POST JSON

{
  "TransmissionResults": "",
  "TransmissionReference": "Test",
  "Version": "8.4.1.7039",
  "TotalRecords": 1,
  "Records": [
    {
      "RecordID": "1",
      "ResultCodes": "AC16,AV24,GS05",
      "ResultError": "",
      "AddressLine1": "22382 Avenida Empresa",
      "AddressLine2": "Rancho Santa Margarita CA 92688-2112",
      "AddressLine3": "",
      "AddressLine4": "",
      "AddressLine5": "",
      "AddressLine6": "",
      "AddressLine7": "",
      "AddressLine8": "",
      "AddressType": "S",
      "FormattedAddress": "Melissa;22382 Avenida Empresa;Rancho Santa Margarita CA 92688-2112",
      "CountryName": "United States of America",
      "Iso2": "US",
      "Iso3": "USA",
      "IsoNumeric": "840",
      "Latitude": "33.637562",
      "Longitude": "-117.606887",
      "SubNationalArea": "",
      "AdministrativeArea": "CA",
      "SubAdministrativeArea": "Orange",
      "Locality": "Rancho Santa Margarita",
      "DependentLocality": "",
      "DoubleDependentLocality": "",
      "PostalCode": "92688-2112",
      "PremisesType": "",
      "PremisesNumber": "22382",
      "SubPremises": "",
      "SubPremisesType": "",
      "SubPremisesNumber": "",
      "Thoroughfare": "Avenida Empresa",
      "ThoroughfarePreDirection": "",
      "ThoroughfareLeadingType": "",
      "ThoroughfareName": "Avenida Empresa",
      "ThoroughfarePostDirection": "",
      "ThoroughfareTrailingType": "",
      "Organization": "Melissa",
      "Building": "",
      "PostBox": "",
      "DependentThoroughfare": "",
      "DependentThoroughfarePreDirection": "",
      "DependentThoroughfareLeadingType": "",
      "DependentThoroughfareName": "",
      "DependentThoroughfarePostDirection": "",
      "DependentThoroughfareTrailingType": "",
      "RecordResult": "AC16,AV24,GS05",
      "SubPremisesLevelNumber": "",
      "SubBuildingType": "",
      "SubBuildingNumber": "",
      "SubBuilding": "",
      "PostOfficeLocation": "",
      "Utc": "UTC-8",
      "Dst": "Y",
      "DeliveryIndicator": "B",
      "MelissaAddressKey": "8008006245",
      "MelissaAddressKeyBase": "",
      "SubPremiseLevelType": "",
      "DeliveryPointSuffix": "",
      "CountrySubDivisionCode": "",
      "AddressKey": "92688211282",
      "Extras":
        {
          "CBSACode": "31080",
          "CBSADivisionCode": "11244",
          "CBSADivisionLevel": "Metropolitan Statistical Area",
          "CBSADivisionTitle": "Anaheim-Santa Ana-Irvine, CA",
          "CBSALevel": "Metropolitan Statistical Area",
          "CBSATitle": "Los Angeles-Long Beach-Anaheim, CA",
          "CarrierRoute": "C057",
          "CensusBlock": "1002",
          "CensusTract": "032053",
          "CensusKey": "060590320531002",
          "CensusKeyDecennial": "",
          "lsad": "",
          "CongressionalDistrict": "40",
          "CountyFIPS": "06059",
          "CountySubdivisionCode": "91977",
          "CountySubdivisionName": "Mission Viejo CCD",
          "DeliveryPointCheckDigit": "1",
          "DeliveryPointCode": "82",
          "ElementarySchoolDistrictName": "",
          "ElementarySchoolDistrictCode": "",
          "PlaceCode": "0659587",
          "PlaceName": "Rancho Santa Margarita",
          "PostalCodeType": "",
          "SecondarySchoolDistrictCode": "",
          "SecondarySchoolDistrictName": "",
          "StateDistrictLower": "071",
          "StateDistrictUpper": "038",
          "UnifiedSchoolDistrictCode": "07440",
          "UnifiedSchoolDistrictName": "Capistrano Unified School District",
          "LocalDateTime": ""
        }
    }
  ]
}

{
  "TransmissionResults": "",
  "TransmissionReference": "Test",
  "Version": "8.4.1.7039",
  "TotalRecords": 1,
  "Records": [
    {
      "RecordID": "1",
      "ResultCodes": "AC16,AV24,GS05",
      "ResultError": "",
      "AddressLine1": "22382 Avenida Empresa",
      "AddressLine2": "Rancho Santa Margarita CA 92688-2112",
      "AddressLine3": "",
      "AddressLine4": "",
      "AddressLine5": "",
      "AddressLine6": "",
      "AddressLine7": "",
      "AddressLine8": "",
      "AddressType": "S",
      "FormattedAddress": "Melissa;22382 Avenida Empresa;Rancho Santa Margarita CA 92688-2112",
      "CountryName": "United States of America",
      "Iso2": "US",
      "Iso3": "USA",
      "IsoNumeric": "840",
      "Latitude": "33.637562",
      "Longitude": "-117.606887",
      "SubNationalArea": "",
      "AdministrativeArea": "CA",
      "SubAdministrativeArea": "Orange",
      "Locality": "Rancho Santa Margarita",
      "DependentLocality": "",
      "DoubleDependentLocality": "",
      "PostalCode": "92688-2112",
      "PremisesType": "",
      "PremisesNumber": "22382",
      "SubPremises": "",
      "SubPremisesType": "",
      "SubPremisesNumber": "",
      "Thoroughfare": "Avenida Empresa",
      "ThoroughfarePreDirection": "",
      "ThoroughfareLeadingType": "",
      "ThoroughfareName": "Avenida Empresa",
      "ThoroughfarePostDirection": "",
      "ThoroughfareTrailingType": "",
      "Organization": "Melissa",
      "Building": "",
      "PostBox": "",
      "DependentThoroughfare": "",
      "DependentThoroughfarePreDirection": "",
      "DependentThoroughfareLeadingType": "",
      "DependentThoroughfareName": "",
      "DependentThoroughfarePostDirection": "",
      "DependentThoroughfareTrailingType": "",
      "RecordResult": "AC16,AV24,GS05",
      "SubPremisesLevelNumber": "",
      "SubBuildingType": "",
      "SubBuildingNumber": "",
      "SubBuilding": "",
      "PostOfficeLocation": "",
      "Utc": "UTC-8",
      "Dst": "Y",
      "DeliveryIndicator": "B",
      "MelissaAddressKey": "8008006245",
      "MelissaAddressKeyBase": "",
      "SubPremiseLevelType": "",
      "DeliveryPointSuffix": "",
      "CountrySubDivisionCode": "",
      "AddressKey": "92688211282",
      "Extras":
        {
          "CBSACode": "31080",
          "CBSADivisionCode": "11244",
          "CBSADivisionLevel": "Metropolitan Statistical Area",
          "CBSADivisionTitle": "Anaheim-Santa Ana-Irvine, CA",
          "CBSALevel": "Metropolitan Statistical Area",
          "CBSATitle": "Los Angeles-Long Beach-Anaheim, CA",
          "CarrierRoute": "C057",
          "CensusBlock": "1002",
          "CensusTract": "032053",
          "CensusKey": "060590320531002",
          "CensusKeyDecennial": "",
          "lsad": "",
          "CongressionalDistrict": "40",
          "CountyFIPS": "06059",
          "CountySubdivisionCode": "91977",
          "CountySubdivisionName": "Mission Viejo CCD",
          "DeliveryPointCheckDigit": "1",
          "DeliveryPointCode": "82",
          "ElementarySchoolDistrictName": "",
          "ElementarySchoolDistrictCode": "",
          "PlaceCode": "0659587",
          "PlaceName": "Rancho Santa Margarita",
          "PostalCodeType": "",
          "SecondarySchoolDistrictCode": "",
          "SecondarySchoolDistrictName": "",
          "StateDistrictLower": "071",
          "StateDistrictUpper": "038",
          "UnifiedSchoolDistrictCode": "07440",
          "UnifiedSchoolDistrictName": "Capistrano Unified School District",
          "LocalDateTime": ""
        }
    }
  ]
}

Service Level Response Fields #

Output Name	Description
TotalRecords	Total number of records.
TransmissionReference	Optional. Serves as a unique request identifier.
TransmissionResults	Lists error codes from any errors caused by the most recent request as a whole.
Version	The current service version number.

Record Level Response Fields #

Output Name	Description
RecordID	The number of the record. Always 1 for a single email request, otherwise it serves as an index of the array of records.
ResultCodes	Comma delimited status, error codes, and change codes for the record.
AddressLine1	These are the string values that will return the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code. If the DeliveryLines option is turned on, only the address up to the dependent locality will be returned.
AddressLine2	Standardized or corrected contents of the input address line 2.
AddressLine3	Standardized or corrected contents of the input address line 3.
AddressLine4	Standardized or corrected contents of the input address line 4.
AddressLine5	Standardized or corrected contents of the input address line 5.
AddressLine6	Standardized or corrected contents of the input address line 6.
AddressLine7	Standardized or corrected contents of the input address line 7.
AddressLine8	Standardized or corrected contents of the input address line 8.
AddressType	A one-character code for the type of address coded. See Product Codes for a list of Address Type Codes.
FormattedAddress	Mailing address. The full mailing address in the preferred format for the country of the address. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required). Separate lines will be delimited by what is specified in the option.
CountryName	Full country name. Can be a nickname.
Iso2	The 2 letter ISO 3166 country code value. For example: US for the United States or CA for Canada.
Iso3	The 3 letter ISO 3166 country code value. For example: USA for the United States or CAN for Canada.
IsoNumeric	The ISO 3166 country number value. For example: 840 for the United States or 124 for Canada.
Latitude	The parsed geographic coordinate for a particular delivery point.
Longitude	The parsed geographic coordinate for a particular delivery point.
SubNationalArea	The standardized arbitrary administrative region below that of the sovereign state. A sub-national area is a logical area unit that is larger than an administrative area but smaller than the country itself. It is extremely rarely used.
AdministrativeArea	State, Province. The standardized contents of the AdministrativeArea element. This is a common geographic area unit for larger countries.
SubAdministrativeArea	County. The standardized contents of the SubAdministrativeArea element. This is a logical area that is smaller than the administrative area but larger than a locality. While many countries can have a sub-administrative area value, it is very rarely used as part of an official address.
Locality	City. The standardized contents of the Locality element. This is the most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, or Postal Town.
DependentLocality	Urbanization. The standardized contents of the DependentLocality element. A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico.
DoubleDependentLocality	The standardized contents of the DoubleDependentLocality element. A double dependent locality is a logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is very rarely used. Great Britain is an example of a country that uses double dependent locality.
PostalCode	ZIP Code. The standardized contents of the PostalCode element. Most countries have some form of a postal code system.
PremisesType	The parsed leading premise type indicator within the premises field.
PremisesNumber	House Number. The parsed alphanumeric indicator within the premises field.
SubPremises	Suite, Apartment. The parsed SubPremises from the AddressLine elements. A subpremise are individual units with their own addresses inside a building.
SubPremisesType	Suite Name. The parsed sub premises type indicator within the premises field.
SubPremisesNumber	Suite Number. The parsed sub premises number indicator within the premises field.
Thoroughfare	Street. The most common street or block data element. This value is a part of the address lines and contains all the sub-elements of the thoroughfare like trailing type, thoroughfare name, pre direction, post direction, etc.
ThoroughfarePreDirection	Street PreDirection. The parsed prefix directional within the Thoroughfare field.
ThoroughfareLeadingType	The parsed leading thoroughfare type indicator within the Thoroughfare field. A leading type is a thoroughfare type that is placed before the thoroughfare. For example, the thoroughfare type of Rue in Canada and France is placed before the thoroughfare, making it a leading type.
ThoroughfareName	Street Name. The parsed name indicator within the Thoroughfare field.
ThoroughfarePostDirection	Post Direction. The parsed postfix directional within the Thoroughfare field.
ThoroughfareTrailingType	Street Suffix. The parsed trailing thoroughfare type indicator within the Thoroughfare field. A trailing type is a thoroughfare type that is placed after the thoroughfare. For example, the thoroughfare type of Avenue in the US is placed after the thoroughfare, making it a trailing type.
Organization	Business, Company. String value that matches the Organization request element. It is not modified or populated by the service.
Building	The parsed descriptive name identifying an individual location.
PostBox	The parsed post box information for a particular delivery point.
DependentThoroughfare	Dependent Street. The parsed block data element. The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.
DependentThoroughfarePreDirection	The parsed prefix directional within the DependentThoroughfare field.
DependentThoroughfareLeadingType	The parsed leading thoroughfare type indicator within the DependentThoroughfare field.
DependentThoroughfareName	The parsed name indicator within the DependentThoroughfare field.
DependentThoroughfarePostDirection	The parsed postfix directional indicator within the DependentThoroughfare field.
DependentThoroughfareTrailingType	The parsed trailing thoroughfare type indicator within the DependentThoroughfare field.
SubPremisesLevelNumber	Sub premises level number indicator within premises field. Parsed from the subPremisesLevel parameter.
SubBuildingType	This is part of the SubBuilding.
SubBuildingNumber	This is part of the SubBuilding.
SubBuilding	A smaller division of the building. For example, if an address has a building name that is a part of a larger set of buildings, then the sub building may be populated. SubBuildingType and SubBuildingNumber make up the parts of SubBuilding.
PostOfficeLocation	The location of the post office in relation to the record address, if available. This may or may not be used in the official mailing address for the country in question. Currently, these are the countries we will return the data for: Serbia and Slovakia.
Utc	The Coordinated Universal Time number in format of `UTC+#`. Note that there are time zones that are not whole hours only, like UTC+9:30.
Dst	`Y` or `N`, based on if the country or area of the input observes daylight savings time. Note that the value returned by the UTC output does not change based on whether the country/area is currently in daylight savings time or not. We will only return the standard timezone and this flag to indicate daylight savings is observed.
DeliveryIndicator	A one-character code that indicates if the address is a residence (R), business (B), or unknown (U). It is not available for all countries. Currently, this field is available for the US, GB, NL and IE with more countries planned in the future. See Product Codes for a list of these codes.
MelissaAddressKey	This is a globally unique and persistent key for the postal address, even if parts of the address change. When an address is fully validated this field returns a 10-digit proprietary unique identifier for that address. With AddressKey (US and Canada only), if an address zip code changes, the AddressKey would also change. Melissa Address Key (MAK) is independent and will not change. This makes MAK a good way to permanently identify and also to use as a value for finding duplicates. Currently, we return MAK numbers for over 50 countries with more planned for the future.
MelissaAddressKeyBase	Every full address has its own Melissa Address Key (MAK). If that address is a suite or apartment, we will also return a Melissa Address Key Base (BaseMAK) that corresponds to the overall building. This provides a link between all the individual MAK addresses that belong to the same building. This field also returns a 10-digit proprietary key. Note, if we can validate the address to the building but not the suite, we can return just the BaseMAK. Currently available for countries that have support for MelissaAddressKey.
SubPremiseLevelType	Floor. Part of the SubPremiseLevel.
DeliveryPointSuffix	This is a country dependent field. This field returns an identifier that represents a suffix code usually tied to a delivery point. GB: This is a 2 character (first is numerical, 2nd character is alphabetic) that is assigned by Royal Mail. When added to the postal code, this allows each live delivery point to be uniquely identified.
CountrySubDivisionCode	This field returns the ISO 3166-2 country sub-division code. This code is part of the ISO 3166 international standard to represent the relevant administrative divisions and dependent territories for a country. For most countries, this code is tied to the administrative area. Not all countries currently return this code but we are planning on adding more.
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 barcodes. 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. The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.

Extras #

Output Name	Activating Option	Description
CBSA Outputs		US Only. Core-Based Statistical Areas (CBSA) outputs. These values are assigned by the US Census. CBSACode CBSADivisionCode CBSADivisionLevel CBSADivisionTitle CBSALevel CBSATitle
CarrierRoute		US Only. Carrier Route Code assigned by the USPS.
CensusBlock		US Only. The Census block number from the most recent yearly census.
CensusTract		US Only. The Census tract number from the most recent yearly census.
CensusKey		This is a country dependent field. It is designed to return a code that corresponds to the census division information for a country. Currently, this field is only returned for the US. US: The CensusKey for the US is a 15- or 16-digit code that is made up of the following components: FIPS Code, Census Tract, Census Block, and CensusBlockGroup if it exists.
CensusKeyDecennial		This is a country dependent field. It is designed to return a code that corresponds to the census division information for a country. Currently, this field is only returned for the US. US: 15-digit string containing the concatenated County FIPS, Census Tract, and Census Block for the most recent Decennial Census. The Decennial Census occurs every 10 years with the most recent available being 2020.
lsad		2-digit string representing the Legal/Statistical Area Description.
CongressionalDistrict		US Only. The congressional district number for the address.
CountyFIPS		US Only. The Census FIPS number from the most recent yearly census.
CountySubdivisionCode		US Only. The county subdivision code value as defined by the US Census.
CountySubdivisionName		US Only. The county subdivision name value as defined by the US Census.
DeliveryPointCheckDigit		US Only. The single digit value that acts as a checksum to the delivery point code.
DeliveryPointCode		US Only. The 2-digit delivery point code as assigned by the USPS.
ElementarySchoolDistrictName		US Only. Returns a 5-digit string representing the elementary school district code for the address.
ElementarySchoolDistrictCode		US Only. Returns a 5-digit string representing the elementary school district code for the address.
PlaceCode		US Only. The FIPS Place code as defined by the Census.
PlaceName		US Only. The FIPS Place name as defined by the Census.
PostalCodeType		This is a country dependent field. This field returns an identifier that represents the type of postal code returned. Currently only the US uses this field. For a list of these codes, see the Product Codes list.
SecondarySchoolDistrictCode		US Only. The secondary school district code for the address.
SecondarySchoolDistrictName		US Only. The secondary school district name for the address.
StateDistrictLower		US Only. Returns a 3-digit string representing the Lower State District Code for the requested record.
StateDistrictUpper		US Only. Returns a 3-digit string representing the Upper State District Code for the requested record.
UnifiedSchoolDistrictCode		US Only. Returns a 5-digit string representing the Unified School District Code if the address is in a unified school district.
UnifiedSchoolDistrictName		US Only. Returns a 5-digit string representing the Unified School District Name if the address is in a unified school district.
DaylightSavingsUTC	`ExtendedDateTime`	Worldwide. The UTC value for the output address when they are observing Daylight savings.
StandardTimezone	`ExtendedDateTime`	Worldwide. The Standard Time Zone Name for the output address.
DaylightSavingsTimezone	`ExtendedDateTime`	Worldwide. The Daylight Savings Time Zone Name for the output address.
LocalDateTime	`ExtendedDateTime`	[BETA] - Worldwide. The local date time value calculated from the OriginDateTime input taking into account the whether the output address area observes daylight savings and the time period when it observes daylight savings. Note that `OriginDateTime` is specified as an option rather than a regular input value.
UPRN	`GBExtras`	GB Only. Returns the Unique Property Reference Number created and maintained by Ordnance Survey.

Result Codes #

For details of all result codes please visit here.

Record Level Result Codes #

Code	Short Description	Long Description
AC - Address Change
`AC01`	Postal Code Change	The postal code was changed or added.
`AC02`	Administrative Area Change	The administrative area (state, province) was added or changed.
`AC03`	Locality Change	The locality (city, municipality) name was added or changed.
`AC09`	Dependent Locality Change	The dependent locality (urbanization) was changed.
`AC10`	Thoroughfare Name Change	The thoroughfare (street) name was added or changed due to a spelling correction.
`AC11`	Thoroughfare Type Change	The thoroughfare (street) leading or trailing type was added or changed, such as from “St” to “Rd.”
`AC12`	Thoroughfare Directional Change	The thoroughfare (street) pre-directional or post-directional was added or changed, such as from “N” to “NW.”
`AC13`	Sub Premise Type Change	The sub premise (suite) type was added or changed, such as from “STE” to “APT.”
`AC14`	Sub Premise Number Change	The sub premise (suite) unit number was added or changed.
`AC15`	Double Dependent Locality Change	The double dependent locality was added or changed.
`AC16`	SubAdministrative Area Change	The subadministrative area was added or changed.
`AC17`	SubNational Area Change	The subnational area was added or changed.
`AC18`	PO Box Change	The PO Box was added or changed.
`AC19`	Premise Type Change	The premise type was added or changed.
`AC20`	House Number Change	The house number was changed.
`AC22`	Organization Change	The organization was added or changed.
AE - Address Error
`AE01`	General Error	The address could not be verified. This is likely due to a missing or invalid locality or postal code.
`AE02`	Unknown Street	Could not match the input street to a unique street name. Either no matches or too many matches found.
`AE03`	Component Mismatch Error	The combination of directionals (N, E, SW, etc) and the suffix (AVE, ST, BLVD) is not correct and produced multiple possible matches.
`AE05`	Multiple Match	The address was matched to multiple records. There is not enough information available in the address to break the tie between multiple records.
`AE08`	Sub Premise Number Invalid	The thoroughfare (street address) was found but the sub premise (suite) was not valid.
`AE09`	Sub Premise Number Missing	The thoroughfare (street address) was found but the sub premise (suite) was missing.
`AE10`	Premise Number Invalid	The premise (house or building) number for the address is not valid.
`AE11`	Premise Number Missing	The premise (house or building) number for the address is missing.
`AE12`	Box Number Invalid	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is invalid.
`AE13`	Box Number Missing	The PO (Post Office Box), RR (Rural Route), or HC (Highway Contract) Box number is missing.
`AE14`	PMB Number Missing	US Only. The address is a Commercial Mail Receiving Agency (CMRA) and the Private Mail Box (PMB or #) number is missing.
`AE17`	Sub Premise Not Required (Deprecated - See AS23)	A sub premise (suite) number was entered but the address does not have secondaries. (Deprecated - See AS23)
AS - Address Status
`AS01`	Address Fully Verified	The address is valid and deliverable according to official postal agencies.
`AS02`	Valid Building Address	The building address was verified but the suite/apartment number is missing or invalid.
`AS03`	Non USPS Address Match	US Only. This US address is not serviced by the USPS but does exist and may receive mail through third party carriers like UPS.
`AS04`	Proprietary Address Format	The address uses a proprietary addressing scheme where only the format could be validated.
`AS09`	Foreign Address	The address is in a non-supported country.
`AS10`	CMRA Address	US Only. The address is a Commercial Mail Receiving Agency (CMRA) like a Mailboxes Etc. These addresses include a Private Mail Box (PMB or #) number.
`AS11`	PBSA Address	A PO Box formatted as a street address for package and mail delivery.
`AS13`	Address Updated By LACS	US Only. The address has been converted by LACSLink® from a rural-style address to a city-style address.
`AS14`	Suite Appended	US Only. A suite was appended by SuiteLink™ using the address and company name.
`AS15`	Apartment Appended	An apartment number was appended by AddressPlus using the address and last name.
`AS16`	Vacant Address	US Only. The address has been unoccupied for more than 90 days.
`AS17`	No USPS Mail Delivery	This address is classified as not receiving mail by the USPS via their No-Stat flag. Delivery might still be possible by third party carriers but that cannot be counted on.
`AS18`	DPV Locked Out	US Only. DPV processing was terminated due to the detection of what is determined to be an artificially created address.
`AS20`	Deliverable only by USPS	US Only. This address can only receive mail delivered through the USPS (i.e. PO Box or a military address).
`AS23`	Extraneous Suite Information	Extraneous information not used in verifying the address was found. This information was returned in the suite field.
`AS24`	USPS Door Not Accessible	Address identified by the USPS where carriers cannot physically access a building or door for mail delivery.
`AS25`	Unique ZIP code	The address contains a USPS unique ZIP code which means any address may be marked as deliverable.
`AS26`	Unknown Data Moved to ParsedGarbage	The input contains data that could not be identified. That data is returned in the ParsedGarbage/AddressExtras field
`AS27`	Phantom Route address	Addresses that are assigned to a phantom route of R777 or R779.
AV - Address Verification
`AV11`	Administrative Area Partial	The address has been partially verified to the Administrative Area (State) Level, which is NOT the highest level possible with the reference data.
`AV12`	Locality Partial	The address has been partially verified to the Locality (City) Level, which is NOT the highest level possible with the reference data.
`AV13`	Thoroughfare Partial	The address has been partially verified to the Thoroughfare (Street) Level, which is NOT the highest level possible with the reference data.
`AV14`	Premise Partial	The address has been partially verified to the Premise (House or Building) Level, which is NOT the highest level possible with the reference data.
`AV21`	Administrative Area Full	The address has been verified to the Administrative Area (State) Level, which is the highest level possible with the reference data.
`AV22`	Locality Full	The address has been verified to the Locality (City) Level, which is the highest level possible with the reference data.
`AV23`	Thoroughfare Full	The address has been verified to the Thoroughfare (Street) Level, which is the highest level possible with the reference data.
`AV24`	Premises Full	The address has been verified to the Premise (House or Building) Level, which is the highest level possible with the reference data.
`AV25`	SubPremises Full	The address has been verified to the SubPremise (Suite) or PO Box Level, which is the highest level possible with the reference data.
GS - Geocode Status
`GS01`	Geocoded to Street Level	The record was coded to the street level (Zip+4 for US, full postal code for CA).
`GS02`	Geocoded to the Neighborhood Level	The record was geocoded down to neighborhood level (Zip+2 for US).
`GS03`	Geocoded to Community Level	The record was coded to the community level (ZIP centroid for US, 3-digit postal code for CA).
`GS04`	Geocoded to State Level	The record was geocoded to the state (administrative area) level.
`GS05`	Geocoded to Rooftop Level	The record was geocoded down to the rooftop level, meaning the point is within the property boundaries, usually the center.
`GS06`	Geocoded to Interpolated Rooftop Level	The record was geocoded down to the rooftop level using interpolation (educated estimations using street coordinates). The point may be in or close to the property boundaries.
GE - Geocode Error
`GE01`	Regional Geocode Not Found	Geocode could not be appended for the input locality or postal code.
`GE02`	No Geocode for Input Address	The input address did not provide enough valid information to append a geocode.

Record Level Product Codes #

Code	Description
Address Type US
`A`	Alias
`F`	Firm or Company
`G`	General Delivery
`H`	Highrise or Business Complex
`P`	PO Box
`R`	Rural Route
`S`	Street or Residential
Address Type Canada
`1`	Street
`2`	Street Served by Route and GD
`3`	Lock Box
`4`	Route Service
`5`	General Delivery
`B`	LVR Street
`C`	Government Street
`D`	LVR Lock Box
`E`	Government Lock Box
`L`	LVR General Delivery
`K`	Building
Address Type Austria
`T`	A door number (Tür) is expected for this address to be considered complete.
Address Type France
`C`	This address is a CEDEX address. These are addresses classified as “Courier d’entreprise à distribution exceptionnelle” or “special business mail” by La Poste. They are given their own postal priority and usually large organizations.
Address Type Great Britain
`L`	This address is identified as having a large user postal code. This is due to the large volume of mail received at that address, or because a PO Box or Selectapost service has been set up.
`S`	This address is identified as having a smaller user postal code. This means this postal code will have usually around 15 delivery points but never more than 100.
Address Type Switzerland
`M`	Domicile and specialist addresses
`S`	Domicile addresses only
`T`	Specialist postcodes only
`F`	Company postcodes
`P`	In-house Swiss Post postcodes (delivery post office information on bundle labels or bag addresses).
Delivery Indicator Code
`R`	Residence
`B`	Business
`U`	Unknown
Postal Code Type
`[Empty]`	Regular postal code
`M`	Military Postal Code
`P`	PO Box Postal Code
`U`	Unique Postal Code usually assigned to a large organization or government institution.

Reference Guide

Contents

Reference Guide#