Global Name:Response

From Melissa Data Wiki
Jump to navigation Jump to search

← Global Name

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



Response

A response is the result of a request. This consists of returned results codes and parsed name elements.

Depending on the protocol used to make the request, the response will be in a certain protocol. Global Name 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 (Base) Version
Transmission Reference TransmissionReference
Transmission Results TransmissionResults
Total Records TotalRecords
Record ID Record RecordID
Results Results
Company Company
Name Prefix NamePrefix
Name First NameFirst
Name Middle NameMiddle
Name Last NameLast
Name Suffix NameSuffix
Nickname NameNickname
Professional Title NameProfTitle
Gender Gender
Name Prefix 2 NamePrefix2
Name First 2 NameFirst2
Name Middle 2 NameMiddle2
Name Last 2 NameLast2
Name Suffix 2 NameSuffix2
Nickname 2 NameNickname2
Professional Title 2 NameProfTitle2
Gender 2 Gender2
Salutation Salutation
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 Name.
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 Name Result Codes.
Protocol Syntax
JSON "TransmissionResults":"string"
SOAP/XML <TransmissionResults>string</TransmissionResults>


Total Records

This is a string value that is the total number of records returned with the response.
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 Name Result Codes.
Protocol Syntax
JSON "Results":"string"
SOAP/XML <Results>string</Results>


Company

This is a string value of the standardized company name. For non-US/CAN records, Known company identifiers (like Corp., GmbH, etc.) will be special cased. All other words will be proper cased. In other words, we don’t make the distinction between acronyms and regular Company names.
Protocol Syntax
JSON "Company":"string"
SOAP/XML <Company>string</Company>


Name Prefix

This is a string value of the first prefix (such as “Mr.” or “Dr.”) from an inputted full name.
If the FullName input property contained a single name, the prefix, if any, will be returned here. If two names were passed, the first of the two prefixes will be returned by this property.
Protocol Syntax
JSON "NamePrefix":"string"
SOAP/XML <NamePrefix>string</NamePrefix>


Name First

This is a string value of the first name from an inputted full name.
If the FullName input property contained a single name, the first name, if any, will be returned here. If two names were passed, the first of the two first names will be returned by this property.
Protocol Syntax
JSON "NameFirst":"string"
SOAP/XML <NameFirst>string</NameFirst>


Name Middle

This is a string value of the middle name from an inputted full name.
If the FullName input property contained a single name, the middle name, if any, will be returned here. If two names were passed, the first of the two middle names will be returned by this property.
Protocol Syntax
JSON "NameMiddle":"string"
SOAP/XML <NameMiddle>string</NameMiddle>


Name Last

This is a string value of the last name from an inputted full name.
If the FullName input property contained a single name, the last name, if any, will be returned here. If two names were passed, the first of the two last names will be returned by this property.
Protocol Syntax
JSON "NameLast":"string"
SOAP/XML <NameLast>string</NameLast>


Name Suffix

This is a string value of the first suffix (such as “Jr.” or “III”) from an inputted full name.
If the FullName input property contained a single name, the suffix, if any, will be returned here. If two names were passed, the first of the two suffixes will be returned by this property.
Protocol Syntax
JSON "NameSuffix":"string"
SOAP/XML <NameSuffix>string</NameSuffix>


Nickname

This is a string value of an identified nickname from an inputted full name.
A nickname is defined as an internal string surrounded by one of the nickname identifying characters [double quote], [single quote] or [parenthesis]. The identified nickname will be returned unstandardized with the identifier intact.
Protocol Syntax
JSON "NameNickname":"string"
XML <NameNickname>string</NameNickname>


Professional Title

This is a string value of the professional title from an inputted full name.
Many countries within the European union identify professional titles as a datatype preceding the first name but separate from a name prefix.
Protocol Syntax
JSON "NameProfTitle":"string"
XML <NameProfTitle>string</NameProfTitle>


Gender

This is a one-character string value indicating the gender of the first name from the input.
Code Description
M Male
F Female
U Unknown first name or no first name present
N A neutral first name


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


Name Prefix 2

This is a string value of the second prefix (such as “Mr.” or “Dr.”) from an inputted full name.
If the FullName input property contained multiple names, the second prefix will be returned here.
Protocol Syntax
JSON "NamePrefix2":"string"
SOAP/XML <NamePrefix2>string</NamePrefix2>


Name First 2

This is a string value of the second first name from an inputted full name.
If the FullName input property contained multiple names, the second first name will be returned here.
Protocol Syntax
JSON "NameFirst2":"string"
SOAP/XML <NameFirst2>string</NameFirst2>


Name Middle 2

This is a string value of the second middle name from an inputted full name.
If the FullName input property contained multiple names, the second middle name, if any, will be returned here.
Protocol Syntax
JSON "NameMiddle2":"string"
SOAP/XML <NameMiddle2>string</NameMiddle2>


Name Last 2

This is a string value of the second last name from an inputted full name.
If the FullName input property contained multiple names, the second last name, if any, will be returned here.
Protocol Syntax
JSON "NameLast2":"string"
SOAP/XML <NameLast2>string</NameLast2>


Name Suffix 2

This is a string value of the second suffix (such as “Jr.” or “III”) from an inputted full name.
If the FullName input property contained multiple names, the second suffix, if any, will be returned here.
Protocol Syntax
JSON "NameSuffix2":"string"
SOAP/XML <NameSuffix2>string</NameSuffix2>


Nickname 2

This is a string value of an identified nickname from an inputted full name.
A nickname is defined as an internal string surrounded by one of the nickname identifying characters [double quote], [single quote] or [parenthesis]. The identified nickname will be returned unstandardized with the identifier intact.
If the FullName input property contained multiple names, the nickname of the second name will be returned here.
Protocol Syntax
JSON "NameNickname2":"string"
XML <NameNickname2>string</NameNickname2>


Professional Title 2

This is a string value of the professional title from an inputted full name.
Many countries within the European union identify professional titles as a datatype preceding the first name but separate from a name prefix.
If the FullName input property contained multiple names, the professional title of the second name will be returned here.
Protocol Syntax
JSON "NameProfTitle2":"string"
XML <NameProfTitle2>string</NameProfTitle2>


Gender 2

This is a one-character string value indicating the gender of the inputted full name.
If the FullName input property contained multiple names, the gender of the second name will be returned here.
Code Description
M Male
F Female
U Unknown first name or no first name present
N A neutral first name


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


Salutation

This is a string value of the response’s name properties which can be used to create a salutation format.
Protocol Syntax
JSON "Salutation":"string"
SOAP/XML <Salutation>string</Salutation>


Extras

This is a string value of the input words not associated with a parsed name part.
Protocol Syntax
JSON "Extras":"string"
SOAP/XML <Extras>string</Extras>