Global Address Verification:Response

From Melissa Data Wiki
Revision as of 16:52, 2 September 2016 by Admin (talk | contribs)
Jump to navigation Jump to search

← 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 Request Version
Transmission Reference Request TransmissionReference
Transmission Results Request TransmissionResults
Total Records Request TotalRecords
Record ID Record RecordID
Results Record Results
Formatted Address Record FormattedAddress
Organization Record Organization
Address Line 1 Record AddressLine1
Address Line 2 Record AddressLine2
Address Line 3 Record AddressLine3
Address Line 4 Record AddressLine4
Address Line 5 Record AddressLine5
Address Line 6 Record AddressLine6
Address Line 7 Record AddressLine7
Address Line 8 Record AddressLine8
Sub Premises Record SubPremises
Double Dependent Locality Record DoubleDependentLocality
Dependent Locality Record DependentLocality
Locality Record Locality
Sub Administrative Area Record SubAdministrativeArea
Administrative Area Record AdministrativeArea
Postal Code Record PostalCode
Address Type Record AddressType
Address Key Record AddressKey
Sub National Area Record SubNationalArea
Country Name Record CountryName
CountryISO3166_1_Alpha2 Record CountryISO3166_1_Alpha2
CountryISO3166_1_Alpha3 Record CountryISO3166_1_Alpha3
CountryISO3166_1_Numeric Record CountryISO3166_1_Numeric
Country Subdivision Code Record CountrySubdivisionCode
Thoroughfare Record Thoroughfare
Thoroughfare Pre Direction Record ThoroughfarePreDirection
Thoroughfare Leading Type Record ThoroughfareLeadingType
Thoroughfare Name Record ThoroughfareName
Thoroughfare Trailing Type Record ThoroughfareTrailingType
Thoroughfare Post Direction Record ThoroughfarePostDirection
Dependent Thoroughfare Record DependentThoroughfare
Dependent Thoroughfare Pre Direction Record DependentThoroughfarePreDirection
Dependent Thoroughfare Leading Type Record DependentThoroughfareLeadingType
Dependent Thoroughfare Name Record DependentThoroughfareName
Dependent Thoroughfare Trailing Type Record DependentThoroughfareTrailingType
Dependent Thoroughfare Post Direction Record DependentThoroughfarePostDirection
Building Record Building
Premises Type Record PremisesType
Premises Number Record PremisesNumber
Sub Premises Type Record SubPremisesType
Sub Premises Number Record SubPremisesNumber
Post Box Record PostBox
Latitude Record Latitude
Longitude Record Longitude


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.
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.
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.
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.
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.
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.
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.
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.
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.
US Term: Suite
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.
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.
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.
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.
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.
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.
Protocol Syntax
JSON "PostalCode":"string"
SOAP/XML <PostalCode>string</PostalCode>


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 and Canadian addresses.
Protocol Syntax
JSON "AddressType":"string"
SOAP/XML <AddressType>string</AddressType>


AddressKey

This is a string value that is a unique key for the address. Only for US and Canadian addresses.

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.
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 parsed CountryISO3166_1_Alpha2 element from the input.

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 parsed CountryISO3166_1_Alpha3 element from the input.

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 parsed CountryISO3166_1_Numeric element from the input.

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 the administrative area for a country. The format is the 2 letter country code followed by a dash followed by 2 characters or two numbers. Examples are: US-CA or CN-16.

Currently, this field is only populated for some countries. These countries are: AU, BR, CA, CN, CR, DM, GT, HN, NI, MX, SV, US.

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


Thoroughfare

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


ThoroughfarePreDirection

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


ThoroughfareLeadingType

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


ThoroughfareName

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


ThoroughfareTrailingType

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


ThoroughfarePostDirection

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


DependentThoroughfare

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


DependentThoroughfarePreDirection

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


DependentThoroughfareLeadingType

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


DependentThoroughfareName

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


DependentThoroughfareTrailingType

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


DependentThoroughfarePostDirection

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


Building

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


PremisesType

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


PremisesNumber

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


SubPremisesType

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


SubPremisesNumber

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


PostBox

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


Latitude

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


Longitude

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