Global Name:Response

← Global Name

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>