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	Request	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
Gender		Gender
Name Prefix 2		NamePrefix2
Name First 2		NameFirst2
Name Middle 2		NameMiddle2
Name Last 2		NameLast2
Name Suffix 2		NameSuffix2
Gender 2		Gender2

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.

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

NamePrefix

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>

NameFirst

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>

NameMiddle

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>

NameLast

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>

NameSuffix

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>

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>

NamePrefix2

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>

NameFirst2

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>

NameMiddle2

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>

NameLast2

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>

NameSuffix2

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>

Gender2

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>