Global Address Verification:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(22 intermediate revisions by the same user not shown)
Line 17: Line 17:
!Field Name !! Level !! JSON/XML
!Field Name !! Level !! JSON/XML
|-
|-
|Version||rowspan="4" valign="center"|Request||Version
|Version||rowspan="4" valign="center"|Response||Version
|-
|-
|Transmission Reference||TransmissionReference
|Transmission Reference||TransmissionReference
Line 25: Line 25:
|Total Records||TotalRecords
|Total Records||TotalRecords
|-
|-
|Record ID||rowspan="47" valign="center"|Record||RecordID
|Record ID||rowspan="63" valign="center"|Record||RecordID
|-
|-
|Results||Results
|Results||Results
Line 62: Line 62:
|-
|-
|Postal Code||PostalCode
|Postal Code||PostalCode
|-
|Postal Code Type||PostalCodeType
|-
|-
|Address Type||AddressType
|Address Type||AddressType
Line 118: Line 120:
|-
|-
|Longitude||Longitude
|Longitude||Longitude
|-
|Delivery Indicator||DeliveryIndicator
|-
|Melissa Address Key||MelissaAddressKey
|-
|Melissa Address Key Base||MelissaAddressKeyBase
|-
|Post Office Location||PostOfficeLocation
|-
|Sub Premise Level||SubPremiseLevel
|-
|Sub Premise Level Type||SubPremiseLevelType
|-
|Sub Premise Level Number||SubPremiseLevelNumber
|-
|Sub Building||SubBuilding
|-
|Sub Building Type||SubBuildingType
|-
|Sub Building Number||SubBuildingNumber
|-
|UTC||UTC
|-
|DST||DST
|-
|Delivery Point Suffix||DeliveryPointSuffix
|-
|Census Key||CensusKey
|-
|Extras||Extras
|}
|}


Line 241: Line 273:


<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 253: Line 285:


<h3 style="background-color:rgb(240,240,240);">AddressLine2</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine2</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 265: Line 297:


<h3 style="background-color:rgb(240,240,240);">AddressLine3</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine3</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 277: Line 309:


<h3 style="background-color:rgb(240,240,240);">AddressLine4</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine4</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 289: Line 321:


<h3 style="background-color:rgb(240,240,240);">AddressLine5</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine5</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 301: Line 333:


<h3 style="background-color:rgb(240,240,240);">AddressLine6</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine6</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 313: Line 345:


<h3 style="background-color:rgb(240,240,240);">AddressLine7</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine7</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 325: Line 357:


<h3 style="background-color:rgb(240,240,240);">AddressLine8</h3>
<h3 style="background-color:rgb(240,240,240);">AddressLine8</h3>
: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.
: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.


:{| class="alternate01"
:{| class="alternate01"
Line 337: Line 369:


<h3 style="background-color:rgb(240,240,240);">SubPremises</h3>
<h3 style="background-color:rgb(240,240,240);">SubPremises</h3>
:This is a string value that is the parsed SubPremises from the AddressLine elements.
:This is a string value that is the parsed SubPremises from the AddressLine elements. A subpremise are individual units with their own addresses inside a building.


:'''US Term:''' Suite
:'''US Term:''' Suite or Apartment


:{| class="alternate01"
:{| class="alternate01"
Line 351: Line 383:


<h3 style="background-color:rgb(240,240,240);">DoubleDependentLocality</h3>
<h3 style="background-color:rgb(240,240,240);">DoubleDependentLocality</h3>
:This is a string value that is the standardized contents of the DoubleDependentLocality element.
:This is a string value that is 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.


:{| class="alternate01"
:{| class="alternate01"
Line 363: Line 395:


<h3 style="background-color:rgb(240,240,240);">DependentLocality</h3>
<h3 style="background-color:rgb(240,240,240);">DependentLocality</h3>
:This is a string value that is the standardized contents of the DependentLocality element.
:This is a string value that is 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.
 
:'''US Term:''' Urbanization


:{| class="alternate01"
:{| class="alternate01"
Line 375: Line 409:


<h3 style="background-color:rgb(240,240,240);">Locality</h3>
<h3 style="background-color:rgb(240,240,240);">Locality</h3>
:This is a string value that is the standardized contents of the Locality element.
:This is a string value that is 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, Postal Town, etc.
 
:'''US Term:''' City


:{| class="alternate01"
:{| class="alternate01"
Line 387: Line 423:


<h3 style="background-color:rgb(240,240,240);">SubAdministrativeArea</h3>
<h3 style="background-color:rgb(240,240,240);">SubAdministrativeArea</h3>
:This is a string value that is the standardized contents of the SubAdministrativeArea element.
:This is a string value that is the standardized contents of the SubAdministrativeArea element. This is a logical area that 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.
 
:'''US Term:''' County


:{| class="alternate01"
:{| class="alternate01"
Line 399: Line 437:


<h3 style="background-color:rgb(240,240,240);">AdministrativeArea</h3>
<h3 style="background-color:rgb(240,240,240);">AdministrativeArea</h3>
:This is a string value that is the standardized contents of the AdministrativeArea element.
:This is a string value that is the standardized contents of the AdministrativeArea element. This is a common geographic area unit for larger countries. Often referred to as State or Province.
 
:'''US Term:''' State


:{| class="alternate01"
:{| class="alternate01"
Line 411: Line 451:


<h3 style="background-color:rgb(240,240,240);">PostalCode</h3>
<h3 style="background-color:rgb(240,240,240);">PostalCode</h3>
:This is a string value that is the standardized contents of the PostalCode element.
:This is a string value that is the standardized contents of the PostalCode element. Most countries have some form of a postal code system.
 
:'''US Term:''' Zip Code


:{| class="alternate01"
:{| class="alternate01"
Line 419: Line 461:
|-
|-
|SOAP/XML||<code><PostalCode>'''''string'''''</PostalCode></code>
|SOAP/XML||<code><PostalCode>'''''string'''''</PostalCode></code>
|}
<h3 style="background-color:rgb(240,240,240);">PostalCodeType</h3>
: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.
:'''Postal Code Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|P
|PO Box Postal Code
|-
|U
|Unique Postal Code usually assigned to a large organization or government institution.
|-
|M
|Military Postal Code
|-
|Empty
|Regular postal code
|}
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PostalCodeType":"'''''string'''''"</code>
|-
|SOAP/XML||<code><PostalCodeType>'''''string'''''</PostalCodeType></code>
|}
|}


Line 424: Line 497:
==Appended Address Record Elements==
==Appended Address Record Elements==
<h3 style="background-color:rgb(240,240,240);">AddressType</h3>
<h3 style="background-color:rgb(240,240,240);">AddressType</h3>
:This is an appended string value that returns a one-character code for the type of address coded. This element works only for US and Canadian addresses.
:This is an appended string value that returns a one-character code for the type of address coded. This element works only for US, Canadian, and Great Britain addresses.
 
:See [[Result Code Details#Global Address Verification|Global Address Verification Result Codes]] for a full list of result codes.
 
:'''US Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|A
|Alias
|-
|F
|Firm or Company
|-
|G
|General Delivery
|-
|H
|Highrise or Business Complex
|-
|P
|PO Box
|-
|R
|Rural Route
|-
|S
|Street  or  Residential
|}
:'''Canadian Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|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
|}
:'''Austria Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|T
|A door number (Tür) is expected for this address to be considered complete.
|}
:'''France Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|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.
|}
:'''Great Britain Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|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.
|}
:'''Switzerland Address Type'''
::{|class="alternate01" cellspacing="0"
!Code
!style="border-right:0px;"|Description
|-
|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).
|}
 


:{| class="alternate01"
:{| class="alternate01"
Line 436: Line 624:


<h3 style="background-color:rgb(240,240,240);">AddressKey</h3>
<h3 style="background-color:rgb(240,240,240);">AddressKey</h3>
:This is a string value that is a unique key for the address. Only for US and Canadian addresses.
: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.


:The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.
:The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.
Line 450: Line 644:


<h3 style="background-color:rgb(240,240,240);">SubNationalArea</h3>
<h3 style="background-color:rgb(240,240,240);">SubNationalArea</h3>
:This is a string value that is the standardized contents of the SubNationalArea element.
:This is a string value that is the standardized contents of the SubNationalArea element. 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.


:{| class="alternate01"
:{| class="alternate01"
Line 474: Line 668:


<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Alpha2</h3>
<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Alpha2</h3>
:This is a string value that is the parsed CountryISO3166_1_Alpha2 element from the input.
:This is a string value that is the 2 letter ISO 3166 country code value.


:For example:
:For example:
Line 499: Line 693:


<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Alpha3</h3>
<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Alpha3</h3>
:This is a string value that is the parsed CountryISO3166_1_Alpha3 element from the input.
:This is a string value that is the 3 letter ISO 3166 country code value.


:For example:
:For example:
Line 524: Line 718:


<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Numeric</h3>
<h3 style="background-color:rgb(240,240,240);">CountryISO3166_1_Numeric</h3>
:This is a string value that is the parsed CountryISO3166_1_Numeric element from the input.
:This is a string value that is the ISO 3166 country number value.


:For example:
:For example:
Line 549: Line 743:


<h3 style="background-color:rgb(240,240,240);">CountrySubdivisionCode</h3>
<h3 style="background-color:rgb(240,240,240);">CountrySubdivisionCode</h3>
:This is the ISO3166-2 code for country subdivisions, usually the administrative area for a country. The format is the 2 or 3 letter country code followed by a dash followed by 2 characters or two numbers. Examples are: US-CA or CN-16.
:This is the ISO3166-2 code for country subdivisions, usually tied to 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. Examples are: US-CA, CN-16, or AU-VIC.


:Currently, this field is only populated for some countries. These countries are: AU, BR, CA, CN, CR, DM, GT, HN, NI, MX, SV, US.
:Currently, this field is only populated for some countries. These countries are: AE, AR, AT, AU, BB, BE, BH, BR,BS, CA, CH, CL, CN, CO, CR, DE, DK, DM, DO, ES, FI, FJ, FR, GB, GH, GT, GY, HN, ID, IE, IL, IN, IS, IT, JP, KR, KW, LT, LU, LV, MX, MY, NC, NG, NI, NL, NO, NZ, PE, PH, PK, PL, PR, PT, RS, SA, SG, SI, SV, TH, TR, UA, US, UY, VN.


:{| class="alternate01"
:{| class="alternate01"
Line 563: Line 757:


<h3 style="background-color:rgb(240,240,240);">Thoroughfare</h3>
<h3 style="background-color:rgb(240,240,240);">Thoroughfare</h3>
:This is a string value that is the parsed Thoroughfare element from the input.
:This is a string value that is the parsed Thoroughfare element from the output. 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.
 
:'''US Term:''' Street


:{| class="alternate01"
:{| class="alternate01"
Line 575: Line 771:


<h3 style="background-color:rgb(240,240,240);">ThoroughfarePreDirection</h3>
<h3 style="background-color:rgb(240,240,240);">ThoroughfarePreDirection</h3>
:This is a string value that is the parsed ThoroughfarePreDirection element from the input.
:This is a string value that is the parsed ThoroughfarePreDirection element from the output. This value is a part of the Thoroughfare field.
 
:'''US Term:''' Pre Direction


:{| class="alternate01"
:{| class="alternate01"
Line 587: Line 785:


<h3 style="background-color:rgb(240,240,240);">ThoroughfareLeadingType</h3>
<h3 style="background-color:rgb(240,240,240);">ThoroughfareLeadingType</h3>
:This is a string value that is the parsed ThoroughfareLeadingType element from the input.
:This is a string value that is the parsed ThoroughfareLeadingType element from the output. A leading type is a thoroughfare type that is placed before the thoroughfare. This value is a part of the Thoroughfare field. For example, the thoroughfare type of "Rue" in Canada and France is placed before the thoroughfare, making it a leading type.
 
:'''US Term:''' Not used in the US


:{| class="alternate01"
:{| class="alternate01"
Line 599: Line 799:


<h3 style="background-color:rgb(240,240,240);">ThoroughfareName</h3>
<h3 style="background-color:rgb(240,240,240);">ThoroughfareName</h3>
:This is a string value that is the parsed ThoroughfareName element from the input.
:This is a string value that is the parsed ThoroughfareName element from the output. This value is a part of the Thoroughfare field.
 
:'''US Term:''' Street name


:{| class="alternate01"
:{| class="alternate01"
Line 611: Line 813:


<h3 style="background-color:rgb(240,240,240);">ThoroughfareTrailingType</h3>
<h3 style="background-color:rgb(240,240,240);">ThoroughfareTrailingType</h3>
:This is a string value that is the parsed ThoroughfareTrailingType element from the input.
:This is a string value that is the parsed ThoroughfareTrailingType element from the output. A trailing type is a thoroughfare type that is placed after the thoroughfare. This value is a part of the Thoroughfare field. For example, the thoroughfare type of "Avenue" in the US is placed after the thoroughfare, making it a trailing type.
 
:'''US Term:''' Street Suffix


:{| class="alternate01"
:{| class="alternate01"
Line 623: Line 827:


<h3 style="background-color:rgb(240,240,240);">ThoroughfarePostDirection</h3>
<h3 style="background-color:rgb(240,240,240);">ThoroughfarePostDirection</h3>
:This is a string value that is the parsed ThoroughfarePostDirection element from the input.
:This is a string value that is the parsed ThoroughfarePostDirection element from the output. This value is a part of the Thoroughfare field.
 
:'''US Term:''' Post Direction


:{| class="alternate01"
:{| class="alternate01"
Line 635: Line 841:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfare</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfare</h3>
:This is a string value that is the parsed DependentThoroughfare element from the input.
:This is a string value that is the parsed DependentThoroughfare element from the output. The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.


:{| class="alternate01"
:{| class="alternate01"
Line 647: Line 853:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePreDirection</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePreDirection</h3>
:This is a string value that is the parsed DependentThoroughfarePreDirection element from the input.
:This is a string value that is the parsed DependentThoroughfarePreDirection element from the output. This value is a part of the DependentThoroughfare field.


:{| class="alternate01"
:{| class="alternate01"
Line 659: Line 865:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareLeadingType</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareLeadingType</h3>
:This is a string value that is the parsed DependentThoroughfareLeadingType element from the input.
:This is a string value that is the parsed DependentThoroughfareLeadingType element from the output. This value is a part of the DependentThoroughfare field.


:{| class="alternate01"
:{| class="alternate01"
Line 671: Line 877:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareName</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareName</h3>
:This is a string value that is the parsed DependentThoroughfareName element from the input.
:This is a string value that is the parsed DependentThoroughfareName element from the output. This value is a part of the DependentThoroughfare field.


:{| class="alternate01"
:{| class="alternate01"
Line 683: Line 889:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareTrailingType</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfareTrailingType</h3>
:This is a string value that is the parsed DependentThoroughfareTrailingType element from the input.
:This is a string value that is the parsed DependentThoroughfareTrailingType element from the output. This value is a part of the DependentThoroughfare field.


:{| class="alternate01"
:{| class="alternate01"
Line 695: Line 901:


<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePostDirection</h3>
<h3 style="background-color:rgb(240,240,240);">DependentThoroughfarePostDirection</h3>
:This is a string value that is the parsed DependentThoroughfarePostDirection element from the input.
:This is a string value that is the parsed DependentThoroughfarePostDirection element from the output. This value is a part of the DependentThoroughfare field.


:{| class="alternate01"
:{| class="alternate01"
Line 707: Line 913:


<h3 style="background-color:rgb(240,240,240);">Building</h3>
<h3 style="background-color:rgb(240,240,240);">Building</h3>
:This is a string value that is the parsed Building element from the input.
:This is a string value that is the parsed Building element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 719: Line 925:


<h3 style="background-color:rgb(240,240,240);">PremisesType</h3>
<h3 style="background-color:rgb(240,240,240);">PremisesType</h3>
:This is a string value that is the parsed PremisesType element from the input.
:This is a string value that is the parsed PremisesType element from the output.  


:{| class="alternate01"
:{| class="alternate01"
Line 731: Line 937:


<h3 style="background-color:rgb(240,240,240);">PremisesNumber</h3>
<h3 style="background-color:rgb(240,240,240);">PremisesNumber</h3>
:This is a string value that is the parsed PremisesNumber element from the input.
:This is a string value that is the parsed PremisesNumber element from the output.
 
:'''US Term:''' House Number


:{| class="alternate01"
:{| class="alternate01"
Line 743: Line 951:


<h3 style="background-color:rgb(240,240,240);">SubPremisesType</h3>
<h3 style="background-color:rgb(240,240,240);">SubPremisesType</h3>
:This is a string value that is the parsed SubPremisesType element from the input.
:This is a string value that is the parsed SubPremisesType element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 755: Line 963:


<h3 style="background-color:rgb(240,240,240);">SubPremisesNumber</h3>
<h3 style="background-color:rgb(240,240,240);">SubPremisesNumber</h3>
:This is a string value that is the parsed SubPremisesNumber element from the input.
:This is a string value that is the parsed SubPremisesNumber element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 767: Line 975:


<h3 style="background-color:rgb(240,240,240);">PostBox</h3>
<h3 style="background-color:rgb(240,240,240);">PostBox</h3>
:This is a string value that is the parsed PostBox element from the input.
:This is a string value that is the parsed PostBox element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 779: Line 987:


<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
:This is a string value that is the parsed Latitude element from the input.
:This is a string value that is the parsed Latitude element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 791: Line 999:


<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
:This is a string value that is the parsed Longitude element from the input.
:This is a string value that is the parsed Longitude element from the output.


:{| class="alternate01"
:{| class="alternate01"
Line 799: Line 1,007:
|-
|-
|SOAP/XML||<code><Longitude>'''''string'''''</Longitude></code>
|SOAP/XML||<code><Longitude>'''''string'''''</Longitude></code>
|}
<h3 style="background-color:rgb(240,240,240);">DeliveryIndicator</h3>
:This field returns 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.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DeliveryIndicator":"'''''string'''''"</code>
|-
|SOAP/XML||<code><DeliveryIndicator>'''''string'''''</DeliveryIndicator></code>
|}
<h3 style="background-color:rgb(240,240,240);">MelissaAddressKey</h3>
: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.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"MelissaAddressKey":"'''''string'''''"</code>
|-
|SOAP/XML||<code><MelissaAddressKey>'''''string'''''</MelissaAddressKey></code>
|}
<h3 style="background-color:rgb(240,240,240);">MelissaAddressKeyBase</h3>
:Every full address has its own Melissa Address Key (MAK). If that address is a suites 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.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"MelissaAddressKeyBase":"'''''string'''''"</code>
|-
|SOAP/XML||<code><MelissaAddressKeyBase>'''''string'''''</MelissaAddressKeyBase></code>
|}
<h3 style="background-color:rgb(240,240,240);">PostOfficeLocation</h3>
:This field, if available for a country, returns the value that is associated to the location of the post office in relation to the address. This value 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.
:{| class="alternate01"
!Country !! Description
|-
|Serbia||The PostOfficeLocation contains the old 5 digit postal number and name. The postal code field will contain the new 6 digit PAK number.
|-
|Slovakia||The PostOfficeLocation returns the name of the post office location if it is not the same as the delivery address locality.
|}
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PostOfficeLocation":"'''''string'''''"</code>
|-
|SOAP/XML||<code><PostOfficeLocation>'''''string'''''</PostOfficeLocation></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubPremiseLevel</h3>
:This is a secondary piece of sub premise information used to describe a more generic division of the subpremise. For example, if you have an address like “1123 Market Way, Floor 12 Apt 25A” then the Subpremises will be “Apt 25A” and the SubPremiseLevel will be “Floor 12”. This value is not widely used in official address data.
:'''SubPremiseLevelType''' and '''SubPremiseLevelNumber''' make up the SubPremiseLevel. In our example, the SubPremiseLevelType is “Floor” and the SubPremiseLevelNumber is “12”.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubPremiseLevel":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubPremiseLevel>'''''string'''''</SubPremiseLevel></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubPremiseLevelType</h3>
:This is part of the '''SubPremiseLevel'''.
:For example: <code>Floor</code>
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubPremiseLevelType":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubPremiseLevelType>'''''string'''''</SubPremiseLevelType></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubPremiseLevelNumber</h3>
:This is part of the '''SubPremiseLevel'''.
:For example: <code>12</code>
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubPremiseLevelNumber":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubPremiseLevelNumber>'''''string'''''</SubPremiseLevelNumber></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubBuilding</h3>
:This value describes 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.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubBuilding":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubBuilding>'''''string'''''</SubBuilding></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubBuildingType</h3>
:This is part of the '''SubBuilding'''.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubBuildingType":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubBuildingType>'''''string'''''</SubBuildingType></code>
|}
<h3 style="background-color:rgb(240,240,240);">SubBuildingNumber</h3>
:This is part of the '''SubBuilding'''.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SubBuildingNumber":"'''''string'''''"</code>
|-
|SOAP/XML||<code><SubBuildingNumber>'''''string'''''</SubBuildingNumber></code>
|}
<h3 style="background-color:rgb(240,240,240);">UTC</h3>
:Returns the Coordinated Universal Time number in format of UTC+#. Note that there are timezones that are not whole hours only, like UTC+9:30.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"UTC":"'''''string'''''"</code>
|-
|SOAP/XML||<code><UTC>'''''string'''''</UTC></code>
|}
<h3 style="background-color:rgb(240,240,240);">DST</h3>
:Returns a Y or a 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 for not. We will only return the standard timezone and this flag to indicate is daylight savings is observed.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DST":"'''''string'''''"</code>
|-
|SOAP/XML||<code><DST>'''''string'''''</DST></code>
|}
<h3 style="background-color:rgb(240,240,240);">DeliveryPointSuffix</h3>
:This is a country dependent field. This field returns an identifier that represents a suffix code usually tied to a delivery point.
:{| class="alternate01"
!Code !! Description
|-
|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.
|}
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"DeliveryPointSuffix":"'''''string'''''"</code>
|-
|SOAP/XML||<code><DeliveryPointSuffix>'''''string'''''</DeliveryPointSuffix></code>
|}
<h3 style="background-color:rgb(240,240,240);">CensusKey</h3>
:This is a country dependent field. It is designed to return a code that correspond 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.
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"CensusKey":"'''''string'''''"</code>
|-
|SOAP/XML||<code><CensusKey>'''''string'''''</CensusKey></code>
|}
==Extras==
<h3 style="background-color:rgb(240,240,240);">Extras</h3>
:This Extras section is a place where we will put less used output fields our more granular country specific output fields. This section is structured differently so that we have the flexibility to expand them in the future. These outputs structured as key/value pairs and the output values present in this section will depend on the options you have selected. The output format for this will look like this example below:
<pre class="indent"><Extras>
    <root>
        <extra>
            <key>CBSACode</key>
            <value>31080</value>
        </extra>
        <extra>
            <key>CBSADivisionCode</key>
            <value>11244</value>
        </extra>
        <extra>
            <key>CBSADivisionLevel</key>
            <value>Metropolitan Statistical Area</value>
        </extra>
    </root>
</Extras></pre>
:Here are the possible output and groups:
:{| class="alternate01"
!Output Name !! Activating Option !! Description
|-
|DaylightSavingsTimezone||ExtendedDateTime||'''Worldwide.''' The Daylight Savings Time Zone Name for the output address
|-
|DaylightSavingsUTC||ExtendedDateTime||'''Worldwide.''' The UTC value for the output address when they are observing Daylight savings
|-
|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 OriginaDateTime is specified as an option rather than a regular input value.
|-
|StandardTimezone||ExtendedDateTime||'''Worldwide.''' The Standard Time Zone Name for the output address
|-
|UPRN||GBExtras||'''GB Only.''' Returns the Unique Property Reference Number created and maintained by Ordnance Survey.
|-
|CarrierRoute||USExtras||'''US Only.''' Carrier Route Code assigned by the USPS
|-
|CBSA Outputs||USExtras||'''US Only.''' Core-Based Statistical Areas (CBSA) outputs. These values are assigned by the US Census.
*CBSACode
*CBSADivisionCode
*CBSADivisionLevel
*CBSADivisionTitle
*CBSALevel
*CBSATitle
|-
|CensusBlock||USExtras||'''US Only.''' The Census block number from the most recent yearly census
|-
|CensusTract||USExtras||'''US Only.''' The Census tract number from the most recent yearly census
|-
|CongressionalDistrict||USExtras||'''US Only.''' The congressional district number for the address
|-
|CountyFIPS||USExtras||'''US Only.''' The Census FIPS number from the most recent yearly census
|-
|CountyName||USExtras||'''US Only.''' The county name that corresponds to the county FIPS code
|-
|CountySubdivisionCode||USExtras||'''US Only.''' The county subdivision code value as defined by the US Census
|-
|CountySubdivisionName||USExtras||'''US Only.''' The county subdivision name value as defined by the US Census
|-
|DeliveryPointCheckDigit||USExtras||'''US Only.''' The single digit value that acts as a checksum to the delivery point code
|-
|DeliveryPointCode||USExtras||'''US Only.''' The 2 digit delivery point code as assigned by the USPS
|-
|ElementarySchoolDistrictCode||USExtras||'''US Only.''' Returns a 5 digit string representing the elementary school district code for the address
|-
|ElementarySchoolDistrictName||USExtras||'''US Only.''' Returns a 5 digit string representing the elementary school district code for the address
|-
|PlaceCode||USExtras||'''US Only.''' The FIPS Place code as defined by the Census
|-
|PlaceName||USExtras||'''US Only.''' The FIPS Place name as defined by the Census
|-
|SecondarySchoolDistrictCode||USExtras||'''US Only.''' The secondary school district code for the address
|-
|SecondarySchoolDistrictName||USExtras||'''US Only.''' The secondary school district name for the address
|-
|StateDistrictLower||USExtras||'''US Only.''' Returns a 3 digit string representing the Lower State District Code for the requested record
|-
|StateDistrictUpper||USExtras||'''US Only.''' Returns a 3 digit string representing the Upper State District Code for the requested record
|-
|UnifiedSchoolDistrictCode||USExtras||'''US Only.''' Returns a 5 digit string representing the Unified School District Code if the address is in a unified school district
|-
|UnifiedSchoolDistrictNameString||USExtras||'''US Only.''' Returns a 5 digit string representing the Unified School District Name if the address is in a unified school district
|}
|}


Latest revision as of 15:19, 25 July 2024

← Global Address Verification

Global Address Navigation
Introduction
Licensing
Input/Output
Request Fields
Response Fields
Examples
REST JSON
REST JSONP
REST XML
Batch JSON
Batch SOAP
Batch XML
Result Codes
Result Code Use
Global Address Verification Result Codes
Sample Code



A response is the result of a request. This consists of returned results codes, parsed address elements, and appended address information.

Depending on the protocol used to make the request, the response will be in a certain protocol. Global Address Verification supports the JSON, JSONP, SOAP, and XML protocols.


Field Names

This is a list of the response field names and their protocol naming conventions.

Field Name Level JSON/XML
Version Response Version
Transmission Reference TransmissionReference
Transmission Results TransmissionResults
Total Records TotalRecords
Record ID Record RecordID
Results Results
Formatted Address FormattedAddress
Organization Organization
Address Line 1 AddressLine1
Address Line 2 AddressLine2
Address Line 3 AddressLine3
Address Line 4 AddressLine4
Address Line 5 AddressLine5
Address Line 6 AddressLine6
Address Line 7 AddressLine7
Address Line 8 AddressLine8
Sub Premises SubPremises
Double Dependent Locality DoubleDependentLocality
Dependent Locality DependentLocality
Locality Locality
Sub Administrative Area SubAdministrativeArea
Administrative Area AdministrativeArea
Postal Code PostalCode
Postal Code Type PostalCodeType
Address Type AddressType
Address Key AddressKey
Sub National Area SubNationalArea
Country Name CountryName
CountryISO3166_1_Alpha2 CountryISO3166_1_Alpha2
CountryISO3166_1_Alpha3 CountryISO3166_1_Alpha3
CountryISO3166_1_Numeric CountryISO3166_1_Numeric
Country Subdivision Code CountrySubdivisionCode
Thoroughfare Thoroughfare
Thoroughfare Pre Direction ThoroughfarePreDirection
Thoroughfare Leading Type ThoroughfareLeadingType
Thoroughfare Name ThoroughfareName
Thoroughfare Trailing Type ThoroughfareTrailingType
Thoroughfare Post Direction ThoroughfarePostDirection
Dependent Thoroughfare DependentThoroughfare
Dependent Thoroughfare Pre Direction DependentThoroughfarePreDirection
Dependent Thoroughfare Leading Type DependentThoroughfareLeadingType
Dependent Thoroughfare Name DependentThoroughfareName
Dependent Thoroughfare Trailing Type DependentThoroughfareTrailingType
Dependent Thoroughfare Post Direction DependentThoroughfarePostDirection
Building Building
Premises Type PremisesType
Premises Number PremisesNumber
Sub Premises Type SubPremisesType
Sub Premises Number SubPremisesNumber
Post Box PostBox
Latitude Latitude
Longitude Longitude
Delivery Indicator DeliveryIndicator
Melissa Address Key MelissaAddressKey
Melissa Address Key Base MelissaAddressKeyBase
Post Office Location PostOfficeLocation
Sub Premise Level SubPremiseLevel
Sub Premise Level Type SubPremiseLevelType
Sub Premise Level Number SubPremiseLevelNumber
Sub Building SubBuilding
Sub Building Type SubBuildingType
Sub Building Number SubBuildingNumber
UTC UTC
DST DST
Delivery Point Suffix DeliveryPointSuffix
Census Key CensusKey
Extras Extras


Response Elements

The following elements are the basic options for each request. These apply to the entire response, not the individual records.

Version

This is a string value that is the current revision number of Global Address Verification.
Protocol Syntax
JSON "Version":"string"
SOAP/XML <Version>string</Version>


Transmission Reference

This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
Protocol Syntax
JSON "TransmissionReference":"string"
SOAP/XML <TransmissionReference>string</TransmissionReference>


Transmission Results

This is a string value that lists error codes from any errors caused by the most recent request as a whole.
For a complete list of error codes, see Global Address Verification Result Codes.
Protocol Syntax
JSON "TransmissionResults":"string"
SOAP/XML <TransmissionResults>string</TransmissionResults>


Total Records

Displays the total number of records returned.
Protocol Syntax
JSON "TotalRecords":"string"
SOAP/XML <TotalRecords>string</TotalRecords>


Response Record Elements

JSON will only contain the Records element.

Protocol Definition
JSON Each record will be contained within [{}] under the Records element.
SOAP
XML

Each of the following elements are returned for each record in the Response Array.


Record ID

This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
Protocol Syntax
JSON "RecordID":"string"
SOAP/XML <RecordID>string</RecordID>


Results

This is a string value with comma delimited status, error codes, and change codes for the record.
For a complete list of codes, see Global Address Verification Result Codes.
Protocol Syntax
JSON "Results":"string"
SOAP/XML <Results>string</Results>


FormattedAddress

This is a string value that is the address in the correct format for mailing from the country specified in the CountryOfOrigin element. 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. See LineSeparator for more information.
Protocol Syntax
JSON "FormattedAddress":"string"
SOAP/XML <FormattedAddress>string</FormattedAddress>


Organization

This is a string value that matches the Organization request element. It is not modified or populated by the Cloud Service.
Protocol Syntax
JSON "Organization":"string"
SOAP/XML <Organization>string</Organization>


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.
Protocol Syntax
JSON "AddressLine1":"string"
SOAP/XML <AddressLine1>string</AddressLine1>


AddressLine2

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.
Protocol Syntax
JSON "AddressLine2":"string"
SOAP/XML <AddressLine2>string</AddressLine2>


AddressLine3

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.
Protocol Syntax
JSON "AddressLine3":"string"
SOAP/XML <AddressLine3>string</AddressLine3>


AddressLine4

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.
Protocol Syntax
JSON "AddressLine4":"string"
SOAP/XML <AddressLine4>string</AddressLine4>


AddressLine5

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.
Protocol Syntax
JSON "AddressLine5":"string"
SOAP/XML <AddressLine5>string</AddressLine5>


AddressLine6

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.
Protocol Syntax
JSON "AddressLine6":"string"
SOAP/XML <AddressLine6>string</AddressLine6>


AddressLine7

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.
Protocol Syntax
JSON "AddressLine7":"string"
SOAP/XML <AddressLine7>string</AddressLine7>


AddressLine8

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.
Protocol Syntax
JSON "AddressLine8":"string"
SOAP/XML <AddressLine8>string</AddressLine8>


SubPremises

This is a string value that is the parsed SubPremises from the AddressLine elements. A subpremise are individual units with their own addresses inside a building.
US Term: Suite or Apartment
Protocol Syntax
JSON "SubPremises":"string"
SOAP/XML <SubPremises>string</SubPremises>


DoubleDependentLocality

This is a string value that is 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.
Protocol Syntax
JSON "DoubleDependentLocality":"string"
SOAP/XML <DoubleDependentLocality>string</DoubleDependentLocality>


DependentLocality

This is a string value that is 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.
US Term: Urbanization
Protocol Syntax
JSON "DependentLocality":"string"
SOAP/XML <DependentLocality>string</DependentLocality>


Locality

This is a string value that is 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, Postal Town, etc.
US Term: City
Protocol Syntax
JSON "Locality":"string"
SOAP/XML <Locality>string</Locality>


SubAdministrativeArea

This is a string value that is the standardized contents of the SubAdministrativeArea element. This is a logical area that 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.
US Term: County
Protocol Syntax
JSON "SubAdministrativeArea":"string"
SOAP/XML <SubAdministrativeArea>string</SubAdministrativeArea>


AdministrativeArea

This is a string value that is the standardized contents of the AdministrativeArea element. This is a common geographic area unit for larger countries. Often referred to as State or Province.
US Term: State
Protocol Syntax
JSON "AdministrativeArea":"string"
SOAP/XML <AdministrativeArea>string</AdministrativeArea>


PostalCode

This is a string value that is the standardized contents of the PostalCode element. Most countries have some form of a postal code system.
US Term: Zip Code
Protocol Syntax
JSON "PostalCode":"string"
SOAP/XML <PostalCode>string</PostalCode>


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.
Postal Code Type
Code Description
P PO Box Postal Code
U Unique Postal Code usually assigned to a large organization or government institution.
M Military Postal Code
Empty Regular postal code


Protocol Syntax
JSON "PostalCodeType":"string"
SOAP/XML <PostalCodeType>string</PostalCodeType>


Appended Address Record Elements

AddressType

This is an appended string value that returns a one-character code for the type of address coded. This element works only for US, Canadian, and Great Britain addresses.
See Global Address Verification Result Codes for a full list of result codes.
US Address Type
Code Description
A Alias
F Firm or Company
G General Delivery
H Highrise or Business Complex
P PO Box
R Rural Route
S Street or Residential
Canadian Address Type
Code Description
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
Austria Address Type
Code Description
T A door number (Tür) is expected for this address to be considered complete.
France Address Type
Code Description
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.
Great Britain Address Type
Code Description
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.
Switzerland Address Type
Code Description
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).


Protocol Syntax
JSON "AddressType":"string"
SOAP/XML <AddressType>string</AddressType>


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.
The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.
Protocol Syntax
JSON "AddressKey":"string"
SOAP/XML <AddressKey>string</AddressKey>


SubNationalArea

This is a string value that is the standardized contents of the SubNationalArea element. 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.
Protocol Syntax
JSON "SubNationalArea":"string"
SOAP/XML <SubNationalArea>string</SubNationalArea>


CountryName

This is a string value that is the standardized contents of the CountryName element.
Protocol Syntax
JSON "CountryName":"string"
SOAP/XML <CountryName>string</CountryName>


CountryISO3166_1_Alpha2

This is a string value that is the 2 letter ISO 3166 country code value.
For example:
Country Code
United States US
Canada CA
Philippines PH


Protocol Syntax
JSON "CountryISO3166_1_Alpha2":"string"
SOAP/XML <CountryISO3166_1_Alpha2>string</CountryISO3166_1_Alpha2>


CountryISO3166_1_Alpha3

This is a string value that is the 3 letter ISO 3166 country code value.
For example:
Country Code
United States USA
Canada CAN
Philippines PHL


Protocol Syntax
JSON "CountryISO3166_1_Alpha3":"string"
SOAP/XML <CountryISO3166_1_Alpha3>string</CountryISO3166_1_Alpha3>


CountryISO3166_1_Numeric

This is a string value that is the ISO 3166 country number value.
For example:
Country Code
United States 840
Canada 124
Philippines 608


Protocol Syntax
JSON "CountryISO3166_1_Numeric":"string"
SOAP/XML <CountryISO3166_1_Numeric>string</CountryISO3166_1_Numeric>


CountrySubdivisionCode

This is the ISO3166-2 code for country subdivisions, usually tied to 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. Examples are: US-CA, CN-16, or AU-VIC.
Currently, this field is only populated for some countries. These countries are: AE, AR, AT, AU, BB, BE, BH, BR,BS, CA, CH, CL, CN, CO, CR, DE, DK, DM, DO, ES, FI, FJ, FR, GB, GH, GT, GY, HN, ID, IE, IL, IN, IS, IT, JP, KR, KW, LT, LU, LV, MX, MY, NC, NG, NI, NL, NO, NZ, PE, PH, PK, PL, PR, PT, RS, SA, SG, SI, SV, TH, TR, UA, US, UY, VN.
Protocol Syntax
JSON "CountrySubdivisionCode":"string"
SOAP/XML <CountrySubdivisionCode>string</CountrySubdivisionCode>


Thoroughfare

This is a string value that is the parsed Thoroughfare element from the output. 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.
US Term: Street
Protocol Syntax
JSON "Thoroughfare":"string"
SOAP/XML <Thoroughfare>string</Thoroughfare>


ThoroughfarePreDirection

This is a string value that is the parsed ThoroughfarePreDirection element from the output. This value is a part of the Thoroughfare field.
US Term: Pre Direction
Protocol Syntax
JSON "ThoroughfarePreDirection":"string"
SOAP/XML <ThoroughfarePreDirection>string</ThoroughfarePreDirection>


ThoroughfareLeadingType

This is a string value that is the parsed ThoroughfareLeadingType element from the output. A leading type is a thoroughfare type that is placed before the thoroughfare. This value is a part of the Thoroughfare field. For example, the thoroughfare type of "Rue" in Canada and France is placed before the thoroughfare, making it a leading type.
US Term: Not used in the US
Protocol Syntax
JSON "ThoroughfareLeadingType":"string"
SOAP/XML <ThoroughfareLeadingType>string</ThoroughfareLeadingType>


ThoroughfareName

This is a string value that is the parsed ThoroughfareName element from the output. This value is a part of the Thoroughfare field.
US Term: Street name
Protocol Syntax
JSON "ThoroughfareName":"string"
SOAP/XML <ThoroughfareName>string</ThoroughfareName>


ThoroughfareTrailingType

This is a string value that is the parsed ThoroughfareTrailingType element from the output. A trailing type is a thoroughfare type that is placed after the thoroughfare. This value is a part of the Thoroughfare field. For example, the thoroughfare type of "Avenue" in the US is placed after the thoroughfare, making it a trailing type.
US Term: Street Suffix
Protocol Syntax
JSON "ThoroughfareTrailingType":"string"
SOAP/XML <ThoroughfareTrailingType>string</ThoroughfareTrailingType>


ThoroughfarePostDirection

This is a string value that is the parsed ThoroughfarePostDirection element from the output. This value is a part of the Thoroughfare field.
US Term: Post Direction
Protocol Syntax
JSON "ThoroughfarePostDirection":"string"
SOAP/XML <ThoroughfarePostDirection>string</ThoroughfarePostDirection>


DependentThoroughfare

This is a string value that is the parsed DependentThoroughfare element from the output. The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.
Protocol Syntax
JSON "DependentThoroughfare":"string"
SOAP/XML <DependentThoroughfare>string</DependentThoroughfare>


DependentThoroughfarePreDirection

This is a string value that is the parsed DependentThoroughfarePreDirection element from the output. This value is a part of the DependentThoroughfare field.
Protocol Syntax
JSON "DependentThoroughfarePreDirection":"string"
SOAP/XML <DependentThoroughfarePreDirection>string</DependentThoroughfarePreDirection>


DependentThoroughfareLeadingType

This is a string value that is the parsed DependentThoroughfareLeadingType element from the output. This value is a part of the DependentThoroughfare field.
Protocol Syntax
JSON "DependentThoroughfareLeadingType":"string"
SOAP/XML <DependentThoroughfareLeadingType>string</DependentThoroughfareLeadingType>


DependentThoroughfareName

This is a string value that is the parsed DependentThoroughfareName element from the output. This value is a part of the DependentThoroughfare field.
Protocol Syntax
JSON "DependentThoroughfareName":"string"
SOAP/XML <DependentThoroughfareName>string</DependentThoroughfareName>


DependentThoroughfareTrailingType

This is a string value that is the parsed DependentThoroughfareTrailingType element from the output. This value is a part of the DependentThoroughfare field.
Protocol Syntax
JSON "DependentThoroughfareTrailingType":"string"
SOAP/XML <DependentThoroughfareTrailingType>string</DependentThoroughfareTrailingType>


DependentThoroughfarePostDirection

This is a string value that is the parsed DependentThoroughfarePostDirection element from the output. This value is a part of the DependentThoroughfare field.
Protocol Syntax
JSON "DependentThoroughfarePostDirection":"string"
SOAP/XML <DependentThoroughfarePostDirection>string</DependentThoroughfarePostDirection>


Building

This is a string value that is the parsed Building element from the output.
Protocol Syntax
JSON "Building":"string"
SOAP/XML <Building>string</Building>


PremisesType

This is a string value that is the parsed PremisesType element from the output.
Protocol Syntax
JSON "PremisesType":"string"
SOAP/XML <PremisesType>string</PremisesType>


PremisesNumber

This is a string value that is the parsed PremisesNumber element from the output.
US Term: House Number
Protocol Syntax
JSON "PremisesNumber":"string"
SOAP/XML <PremisesNumber>string</PremisesNumber>


SubPremisesType

This is a string value that is the parsed SubPremisesType element from the output.
Protocol Syntax
JSON "SubPremisesType":"string"
SOAP/XML <SubPremisesType>string</SubPremisesType>


SubPremisesNumber

This is a string value that is the parsed SubPremisesNumber element from the output.
Protocol Syntax
JSON "SubPremisesNumber":"string"
SOAP/XML <SubPremisesNumber>string</SubPremisesNumber>


PostBox

This is a string value that is the parsed PostBox element from the output.
Protocol Syntax
JSON "PostBox":"string"
SOAP/XML <PostBox>string</PostBox>


Latitude

This is a string value that is the parsed Latitude element from the output.
Protocol Syntax
JSON "Latitude":"string"
SOAP/XML <Latitude>string</Latitude>


Longitude

This is a string value that is the parsed Longitude element from the output.
Protocol Syntax
JSON "Longitude":"string"
SOAP/XML <Longitude>string</Longitude>


DeliveryIndicator

This field returns 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.
Protocol Syntax
JSON "DeliveryIndicator":"string"
SOAP/XML <DeliveryIndicator>string</DeliveryIndicator>


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.
Protocol Syntax
JSON "MelissaAddressKey":"string"
SOAP/XML <MelissaAddressKey>string</MelissaAddressKey>


MelissaAddressKeyBase

Every full address has its own Melissa Address Key (MAK). If that address is a suites 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.
Protocol Syntax
JSON "MelissaAddressKeyBase":"string"
SOAP/XML <MelissaAddressKeyBase>string</MelissaAddressKeyBase>


PostOfficeLocation

This field, if available for a country, returns the value that is associated to the location of the post office in relation to the address. This value 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.
Country Description
Serbia The PostOfficeLocation contains the old 5 digit postal number and name. The postal code field will contain the new 6 digit PAK number.
Slovakia The PostOfficeLocation returns the name of the post office location if it is not the same as the delivery address locality.


Protocol Syntax
JSON "PostOfficeLocation":"string"
SOAP/XML <PostOfficeLocation>string</PostOfficeLocation>


SubPremiseLevel

This is a secondary piece of sub premise information used to describe a more generic division of the subpremise. For example, if you have an address like “1123 Market Way, Floor 12 Apt 25A” then the Subpremises will be “Apt 25A” and the SubPremiseLevel will be “Floor 12”. This value is not widely used in official address data.
SubPremiseLevelType and SubPremiseLevelNumber make up the SubPremiseLevel. In our example, the SubPremiseLevelType is “Floor” and the SubPremiseLevelNumber is “12”.
Protocol Syntax
JSON "SubPremiseLevel":"string"
SOAP/XML <SubPremiseLevel>string</SubPremiseLevel>


SubPremiseLevelType

This is part of the SubPremiseLevel.
For example: Floor
Protocol Syntax
JSON "SubPremiseLevelType":"string"
SOAP/XML <SubPremiseLevelType>string</SubPremiseLevelType>


SubPremiseLevelNumber

This is part of the SubPremiseLevel.
For example: 12
Protocol Syntax
JSON "SubPremiseLevelNumber":"string"
SOAP/XML <SubPremiseLevelNumber>string</SubPremiseLevelNumber>


SubBuilding

This value describes 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.
Protocol Syntax
JSON "SubBuilding":"string"
SOAP/XML <SubBuilding>string</SubBuilding>


SubBuildingType

This is part of the SubBuilding.
Protocol Syntax
JSON "SubBuildingType":"string"
SOAP/XML <SubBuildingType>string</SubBuildingType>


SubBuildingNumber

This is part of the SubBuilding.
Protocol Syntax
JSON "SubBuildingNumber":"string"
SOAP/XML <SubBuildingNumber>string</SubBuildingNumber>


UTC

Returns the Coordinated Universal Time number in format of UTC+#. Note that there are timezones that are not whole hours only, like UTC+9:30.
Protocol Syntax
JSON "UTC":"string"
SOAP/XML <UTC>string</UTC>


DST

Returns a Y or a 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 for not. We will only return the standard timezone and this flag to indicate is daylight savings is observed.
Protocol Syntax
JSON "DST":"string"
SOAP/XML <DST>string</DST>


DeliveryPointSuffix

This is a country dependent field. This field returns an identifier that represents a suffix code usually tied to a delivery point.
Code Description
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.
Protocol Syntax
JSON "DeliveryPointSuffix":"string"
SOAP/XML <DeliveryPointSuffix>string</DeliveryPointSuffix>


CensusKey

This is a country dependent field. It is designed to return a code that correspond 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.


Protocol Syntax
JSON "CensusKey":"string"
SOAP/XML <CensusKey>string</CensusKey>


Extras

Extras

This Extras section is a place where we will put less used output fields our more granular country specific output fields. This section is structured differently so that we have the flexibility to expand them in the future. These outputs structured as key/value pairs and the output values present in this section will depend on the options you have selected. The output format for this will look like this example below:
<Extras>
    <root>
        <extra>
            <key>CBSACode</key>
            <value>31080</value>
        </extra>
        <extra>
            <key>CBSADivisionCode</key>
            <value>11244</value>
        </extra>
        <extra>
            <key>CBSADivisionLevel</key>
            <value>Metropolitan Statistical Area</value>
        </extra>
    </root>
</Extras>
Here are the possible output and groups:
Output Name Activating Option Description
DaylightSavingsTimezone ExtendedDateTime Worldwide. The Daylight Savings Time Zone Name for the output address
DaylightSavingsUTC ExtendedDateTime Worldwide. The UTC value for the output address when they are observing Daylight savings
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 OriginaDateTime is specified as an option rather than a regular input value.
StandardTimezone ExtendedDateTime Worldwide. The Standard Time Zone Name for the output address
UPRN GBExtras GB Only. Returns the Unique Property Reference Number created and maintained by Ordnance Survey.
CarrierRoute USExtras US Only. Carrier Route Code assigned by the USPS
CBSA Outputs USExtras US Only. Core-Based Statistical Areas (CBSA) outputs. These values are assigned by the US Census.
  • CBSACode
  • CBSADivisionCode
  • CBSADivisionLevel
  • CBSADivisionTitle
  • CBSALevel
  • CBSATitle
CensusBlock USExtras US Only. The Census block number from the most recent yearly census
CensusTract USExtras US Only. The Census tract number from the most recent yearly census
CongressionalDistrict USExtras US Only. The congressional district number for the address
CountyFIPS USExtras US Only. The Census FIPS number from the most recent yearly census
CountyName USExtras US Only. The county name that corresponds to the county FIPS code
CountySubdivisionCode USExtras US Only. The county subdivision code value as defined by the US Census
CountySubdivisionName USExtras US Only. The county subdivision name value as defined by the US Census
DeliveryPointCheckDigit USExtras US Only. The single digit value that acts as a checksum to the delivery point code
DeliveryPointCode USExtras US Only. The 2 digit delivery point code as assigned by the USPS
ElementarySchoolDistrictCode USExtras US Only. Returns a 5 digit string representing the elementary school district code for the address
ElementarySchoolDistrictName USExtras US Only. Returns a 5 digit string representing the elementary school district code for the address
PlaceCode USExtras US Only. The FIPS Place code as defined by the Census
PlaceName USExtras US Only. The FIPS Place name as defined by the Census
SecondarySchoolDistrictCode USExtras US Only. The secondary school district code for the address
SecondarySchoolDistrictName USExtras US Only. The secondary school district name for the address
StateDistrictLower USExtras US Only. Returns a 3 digit string representing the Lower State District Code for the requested record
StateDistrictUpper USExtras US Only. Returns a 3 digit string representing the Upper State District Code for the requested record
UnifiedSchoolDistrictCode USExtras US Only. Returns a 5 digit string representing the Unified School District Code if the address is in a unified school district
UnifiedSchoolDistrictNameString USExtras US Only. Returns a 5 digit string representing the Unified School District Name if the address is in a unified school district
Retrieved from "http://wiki.melissadata.com/index.php?title=Global_Address_Verification:Response&oldid=20145"