# Verify an identity

Uses HTTP GET to accept one input record and returns the response in JSON format.

Endpoint: GET /doContactVerify

## Query parameters:

  - `act` (string)
    The actions the service will perform on input data. For every request, a Check action is always performed on the input.

- Check: Determines whether the data within a submitted record is valid, e.g. whether or not a given postal code contains the given city. It can also make limited corrections and appends to the data. Check looks at each data point separately.
- Screen: Screens the provided input against various government sanctions and watchlists and returns back a list of matches. For a list of used watchlists, see Personator Identity Watchlists.
- Verify: After the data has been checked, identity verification is performed and result codes (KV*) are returned to indicate what pieces of input data have been matched against trusted referenced data.
    Enum: "check", "screen", "verify"

  - `id` (string, required)
    The License Key issued by Melissa
    Example: "{REPLACE-WITH-YOUR-LICENSE-KEY}"

  - `t` (string)
    Transmission Reference - Serves as a unique identifier for this set of records.
    Example: "Test"

  - `addrOpt` (string)
    Address Options - To be set when an address is being validated during the Check action.

List options in the following format, with multiple options delimited with a comma ,.

For example: OptionName:Parameter,OptionName:Parameter.
- CountryOfOrigin: - This is used to determine whether or not to include the country name as the last line in FormattedAddress.
- DeliveryLines: - This options allows you to specify if the Address Lines 1-8 should contain just the delivery address or the entire address. Default of 'Off' will return the entire address.
- LineSeparator: - This is the line separator used for the FormattedAddress result. Default of SEMICOLON will use a semicolon ;.
- OutputScript: - This is the script type used for all applicable fields. Default of NOCHANGE will return the same script that is sent in.
    Example: "CountryOfOrigin:US,DeliveryLines:Off,LineSeparator:SEMICOLON,OutputScript:NOCHANGE"

  - `emailOpt` (string)
    Email Options - To be set when an email is being validated during the Check action.

List options in the following format, with multiple options delimited with a comma ,.

For example: OptionName:Parameter,OptionName:Parameter.
- DomainCorrection: - Default of On activates fuzzy email domain correction if the domain is a suspected typo.
- TimeToWait: - TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single email before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Defaults to 25.
- VerifyMailBox: - Default of Express quickly validates against database of known email addresses. Premium has a real time check performed to determine email deliverability.
    Example: "DomainCorrection:On,TimeToWait:10,VerifyMailBox:Express"

  - `nameOpt` (string)
    Name Options - To be set when a name is being validated during the Check action.

- Full or normal name order is: Prefix, First, Middle, Last, Suffix.
- Inverse name order is: Last, Suffix, Prefix, First, Middle.

Either the Code or Name can be used to set the action. List options in the following format, with multiple options delimited with a comma ,.

For example: OptionName:Parameter,OptionName:Parameter.
- CorrectFirstName: - This option enables or disables spelling correction of first names. Default of OFF preserves first name spellings; no correction allowed.
- GenderAggression: - This option sets how aggressively the service will attempt to genderize neutral first names.

  - 1 or Aggressive -Aggressive name genderizing.
  - 2 or Neutral - Default. Neutral name genderizing.
  - 3 or Conservative - Conservative name genderizing.
- GenderPopulation: - This option sets the gender balance of the source data, predominantly male, predominantly female, or neutral.

  - 1 or Male - Bias towards Male.
  - 2 or Mixed - Default. No bias towards either gender.
  - 3 or Female - Bias towards Female.
- NameHint: - This option sets the most likely format of the FullName input string. This helps the service in cases where the order and formatting of the FullName input string are unclear.

  - 1 or DefinitelyFull - Name will always be treated as normal name order regardless of formatting or punctuation.
  - 4 or Varying - Default. Name will be treated as normal name order unless formatting or punctuation indicates otherwise.
  - 7 or DefinitelyInverse - Name will always be treated as inverse name order regardless of formatting or punctuation.
    Example: "CorrectFirstName:OFF,GenderAggression:2,GenderPopulation:Mixed,NameHint:Varying"

  - `opt` (string)
    Options - Pass in options you want to set for the request.

List options in the following format, with multiple options delimited with a comma ,.

For example: OptionName:Parameter,OptionName:Parameter.
- Consent: - This option is for data sources that require consent to be given - acknowledging that consent is given to allow the data to be verified by external data sources. Default of No indicates that no consent was given.
    Example: "Consent:No"

  - `phoneOpt` (string)
    Phone Options - To be set when a phone number is being validated during the Check action.

List options in the following format, with multiple options delimited with a comma ,.

For example: OptionName:Parameter,OptionName:Parameter.
- CallerID: - US and Canada Only. Default of False turns CallerID off.
- DefaultCallingCode: - This is used when the country could not be detected from the phone number or country input. The default of a blank field will check the sequence of digits found after the leading +.
- TimeToWait: - TimeToWait allows you to select how long (in seconds) that you would like our Cloud API to wait on a single request before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results. Default set to 2.
- VerifyPhone: - This sets the level of verification to be done on a phone check. Default of Express will validate against a database of known phone numbers.
    Example: "CallerID:False,DefaultCallingCode:1,TimeToWait:5,VerifyPhone:Express"

  - `privacy` (string)
    Privacy - This Option allows data elements to be redacted from the response. The user can submit any combination of data elements to redact, or all elements. All result codes will be returned to the client will be returned to the user.

List options in the following format, with multiple options delimited with a comma ,.

For example: Privacy:value1,value2,value3.
- Privacy: - Default of [None] will return all data elements.

  - `accountNumber` (string)
    Account Number - The input field for account number. This should contain an IBAN or SWIFT number.

  - `a1` (string, required)
    Address Line 1 - The input field for the address. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
    Example: "22382 Avenida Empresa"

  - `a2` (string)
    Address Line 2 - The input field for the address.

  - `a3` (string)
    Address Line 3 - The input field for the address.

  - `a4` (string)
    Address Line 4 - The input field for the address.

  - `a5` (string)
    Address Line 5 - The input field for the address.

  - `a6` (string)
    Address Line 6 - The input field for the address.

  - `a7` (string)
    Address Line 7 - The input field for the address.

  - `a8` (string)
    Address Line 8 - The input field for the address.

  - `admarea` (string, required)
    Administrative Area - State, Province. The most common geographic data element.
    Example: "CA"

  - `comp` (string)
    Company - The company/organization name to be standardized.

  - `ctry` (string, required)
    Country - The country name, abbreviation, or code.
    Example: "US"

  - `ctryorg` (string)
    Country of Origin - This is used to determine whether or not to include the country name as the last line in the FormattedAddress field.

  - `dob` (string)
    Date of Birth - The date of birth to be verified. The expected input format is YYYYMMDD.

  - `email` (string)
    Email - The email address to be verified.
    Example: "info@melissa.com"

  - `first` (string)
    First Name - The given (first) name for the individual.

  - `full` (string, required)
    Full Name - The full name to be genderized, standardized, and parsed. This will only be done if the first name and last name fields are left blank.
    Example: "John Smith"

  - `last` (string)
    Last Name - The family (last) name or surname for the individual.

  - `loc` (string, required)
    Locality - City, Municipality. The most common population center data element.
    Example: "Rancho Santa Margarita"

  - `nat` (string)
    National ID - Social Security Number. The national ID specific to the country.

  - `phone` (string)
    Phone Number - The phone number to be verified.
    Example: "1-800-635-4772"

  - `postal` (string, required)
    Postal Code - ZIP, Postcode. The complete postal code for a particular delivery point. If all three elements are provided and the PostalCode is incorrect, it can be corrected from the data on the Locality and AdministrativeArea.
    Example: "92688"

## Response 200 fields (application/json):

  - `Results` (string)
    Lists error codes from any errors caused by the most recent request as a whole.

  - `TransactionID` (string)
    A unique string identifier for this record. A unique transaction ID is generated for every record handled by Personator Identity.

  - `TransmissionReference` (string)
    Serves as a unique request identifier.

  - `Version` (string)
    The current service version number.

  - `Address` (object)

  - `Address.AddressLine1` (string)
    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.

  - `Address.AddressLine2` (string)
    Standardized or corrected contents of the input address line 2.

  - `Address.AddressLine3` (string)
    Standardized or corrected contents of the input address line 3.

  - `Address.AddressLine4` (string)
    Standardized or corrected contents of the input address line 4.

  - `Address.AddressLine5` (string)
    Standardized or corrected contents of the input address line 5.

  - `Address.AddressLine6` (string)
    Standardized or corrected contents of the input address line 6.

  - `Address.AddressLine7` (string)
    Standardized or corrected contents of the input address line 7.

  - `Address.AddressLine8` (string)
    Standardized or corrected contents of the input address line 8.

  - `Address.AdministrativeArea` (string)
    State, Province. The standardized contents of the AdministrativeArea element. This is a common geographic area unit for larger countries.

  - `Address.DependentLocality` (string)
    Urbanization. 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.

  - `Address.DoubleDependentLocality` (string)
    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.

  - `Address.FormattedAddress` (string)
    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).

  - `Address.Locality` (string)
    City. 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, or Postal Town.

  - `Address.Organization` (string)
    Business, Company. String value that matches the Organization request element. It is not modified or populated by the service.

  - `Address.PostalCode` (string)
    ZIP Code. The standardized contents of the PostalCode element. Most countries have some form of a postal code system.

  - `Address.Results` (string)
    Comma delimited status, error codes, and change codes for the record. For a list of these codes, see the [Result Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html) list.

Separate lines will be delimited by what is specified in the [LineSeparator](https://docs.melissa.com/cloud-api/personator-identity/personator-identity-reference-guide.html#personatoridentity-referenceguide-addressoptions-lineseparator) option.

  - `Address.SubAdministrativeArea` (string)
    County. 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.

  - `Address.SubPremises` (string)
    Suite, Apartment. The parsed SubPremises from the AddressLine elements. A subpremise are individual units with their own addresses inside a building.

  - `Address.AddressKey` (string)
    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 services, such as Geocoder or RBDI.

  - `Address.AddressType` (string)
    A one-character code for the type of address coded.

See the [Product Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html#personatoridentity-referenceguide-resultcodes-productcodes) for a list of Address Type Codes.

  - `Address.Building` (string)
    The parsed descriptive name identifying an individual location.

  - `Address.CountryCode` (string)
    The 2 letter ISO 3166 country code value.

For example: US for United States or CA for Canada.

  - `Address.CountryISO3` (string)
    The 3 letter ISO 3166 country code value.

For example: USA for United States or CAN for Canada.

  - `Address.CountryName` (string)
    The standardized contents of the CountryName element.

  - `Address.CountryNumber` (string)
    The ISO 3166 country number value.

For example: 840 for United States or 124 for Canada.

  - `Address.CountrySubdivisionCode` (string)
    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.

For example: US-CA, CN-16, or AU-VIC.

This field is only populated for the following countries: 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.

  - `Address.DependentThoroughfare` (string)
    Dependent Street. The parsed block data element.

The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.

  - `Address.DependentThoroughfareLeadingType` (string)
    The parsed leading thoroughfare type indicator within the DependentThoroughfare field.

  - `Address.DependentThoroughfareName` (string)
    The parsed name indicator within the DependentThoroughfare field.

  - `Address.DependentThoroughfarePostDirection` (string)
    The parsed postfix directional indicator within the DependentThoroughfare field.

  - `Address.DependentThoroughfarePreDirection` (string)
    The parsed prefix directional within the DependentThoroughfare field.

  - `Address.DependentThoroughfareTrailingType` (string)
    The parsed trailing thoroughfare type indicator within the DependentThoroughfare field.

  - `Address.Latitude` (string)
    The parsed geographic coordinate for a particular delivery point.

  - `Address.Longitude` (string)
    The parsed geographic coordinate for a particular delivery point.

  - `Address.PostBox` (string)
    The parsed post box information for a particular delivery point.

  - `Address.PremisesNumber` (string)
    House Number. The parsed alphanumeric indicator within the premises field.

  - `Address.PremisesType` (string)
    The parsed leading premise type indicator within the premises field.

  - `Address.SubNationalArea` (string)
    The standardized arbitrary administrative region below that of the sovereign state.

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.

  - `Address.SubPremisesNumber` (string)
    Suite Number. The parsed sub premises number indicator within the premises field.

  - `Address.SubPremisesType` (string)
    Suite Name. The parsed sub premises type indicator within the premises field.

  - `Address.Thoroughfare` (string)
    Street. The most common street or block data element.

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.

  - `Address.ThoroughfareLeadingType` (string)
    The parsed leading thoroughfare type indicator within the Thoroughfare field.

A leading type is a thoroughfare type that is placed before the thoroughfare.

For example, the thoroughfare type of Rue in Canada and France is placed before the thoroughfare, making it a leading type.

  - `Address.ThoroughfareName` (string)
    Street Name. The parsed name indicator within the Thoroughfare field.

  - `Address.ThoroughfarePostDirection` (string)
    Post Direction. The parsed postfix directional within the Thoroughfare field.

  - `Address.ThoroughfarePreDirection` (string)
    Street PreDirection. The parsed prefix directional within the Thoroughfare field.

  - `Address.ThoroughfareTrailingType` (string)
    Street Suffix. The parsed trailing thoroughfare type indicator within the Thoroughfare field.

A trailing type is a thoroughfare type that is placed after the thoroughfare.

For example, the thoroughfare type of Avenue in the US is placed after the thoroughfare, making it a trailing type.

  - `Email` (object)

  - `Email.BreachCount` (string)
    The known number of breaches that this email account has been involved in.

  - `Email.DateChecked` (string)
    The date the email was validated. It returns UTC, Unix Time (Epoch Time) in the MM/DD/YYYY H:MM:SS format.

  - `Email.DeliverabilityConfidenceScore` (string)
    The probability [0-100]% of an email sent to this mailbox will be successfully delivered.

  - `Email.DomainAddress1` (string)
    The address of the DomainOrganization.

  - `Email.DomainAdministrativeArea` (string)
    The state of the DomainOrganization.

  - `Email.DomainAgeEstimated` (string)
    The estimated age of the domain in days.

  - `Email.DomainAvailability` (string)
    Check to see if domain is available for purchase.

  - `Email.DomainCountry` (string)
    The country of the DomainOrganization.

  - `Email.DomainCountryCode` (string)
    The country code of the DomainCountry.

  - `Email.DomainCreatedDate` (string)
    The date the domain was created in the YYYY-MM-DDTHH:MM:SS format.

  - `Email.DomainEmail` (string)
    The email associated with the domain owner.

  - `Email.DomainExpirationDate` (string)
    The date the domain expires/expired in the YYYY-MM-DDTHH:MM:SS format. This is When the domain will be renewed or available to buy.

  - `Email.DomainLocality` (string)
    The city of the DomainOrganization.

  - `Email.DomainName` (string)
    The domain name portion of the email address. (All characters between the “@” and “.” characters.).

  - `Email.DomainOrganization` (string)
    The company associated with the domain owner.

  - `Email.DomainPostalCode` (string)
    The postal code of the DomainOrganization.

  - `Email.DomainPrivateProxy` (string)
    Check if domain is behind a private proxy.

  - `Email.DomainUpdatedDate` (string)
    The date the domain was last updated in the YYYY-MM-DDTHH:MM:SS format.

  - `Email.EmailAddress` (string)
    The email address or domain, including any correcctions or updates made by the service.

  - `Email.EmailAgeEstimated` (string)
    The estimated minimum age of the email in days based on historical data. The value is zero when we lack historical data on a given email.

  - `Email.MailboxName` (string)
    The mailbox or user name portion of the email address (Everything before the “@” in the email address).

  - `Email.MXServer` (string)
    Premium only. The Mail Exchange (MX) Server used to validate the email.

  - `Email.PrivacyFlag` (string)
    Is this email affected by additional privacy regulations, such as GDPR. Returns Y for yes and N for no.

  - `Email.Results` (string)
    Comma delimited status, error codes, and change codes for the record.

See the [Result Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html#personatoridentity-resultcodesfull) for a full list.

  - `Email.TopLevelDomain` (string)
    The description associated with the top-level domain name of the email address (e.g. com is Commercial).

  - `Email.TopLevelDomainName` (string)
    The top level domain name portion of the email address (All characters after the “.”, e.g. com).

  - `Identity` (object)

  - `Identity.AccountNumber` (object)
    An object that returns one field for account number status.

Example:
"AccountNumber": {
"Validated":"Y"
}

  - `Identity.AccountNumber.Validated` (string)
    Returns a string containing either Y or N.

  - `Identity.BusinessInformation` (object)
    An object that returns the following Business Information

  - `Identity.BusinessInformation.Name` (string)
    Name of the business that matched

  - `Identity.BusinessInformation.ID` (string)
    Business ID. Uses the official business ID specific to the country:
- US: EIN
- SG: Unique Entity Number
- CA: Corporations Number or Business Number
- DE: German Trade Register or Handelsregister (HRB)

  - `Identity.BusinessInformation.Status` (string)
    The current status of the business. e.g. Active.

  - `Identity.BusinessInformation.Type` (string)
    Business Type, e.g. Corporation, Limited Liability Company.

  - `Identity.BusinessInformation.RegistrationDate` (string)
    Registration Date of the business, in the YYYY-MM-DD format.

  - `Identity.Confidence` (string)
    This indicates how reliable the record is after performing ID verification.

The 3 possible values returned:
- High: Passing or high quality score
- Medium: Possible pass with multiple matching elements
- Low: None or minimal match rate

  - `Identity.DateOfBirth` (string)
    The input date of birth returned as is.

  - `Identity.Datasources` (array)
    Contains an array of data sources where a match is found against the input.

This field is only available when the Verify action is specified. Otherwise a null value is returned.

Example:
"Datasources":
  [
  "DatasourceName":"",
  "Results":"",
  "Messages":
    [{
      "ResultCode":"",
      "Description":""
    }]
  ]

  - `Identity.Datasources.DatasourceName` (string)
    A string value indicating the name/type of data source.

  - `Identity.Datasources.Results` (string)
    A string value containing the KV* result codes, indicating how the input matched against this particular data source.

  - `Identity.Datasources.Messages` (array)
    An array object, listing the meaning of each KV* result code for this data source.

  - `Identity.Datasources.Messages.ResultCode` (string)
    The particular KV* result code.

  - `Identity.Datasources.Messages.Description` (string)
    A string value containing the description/meaning of the KV* result code.

  - `Identity.NationalID` (string)
    The input national ID returned as is.

  - `Identity.Watchlists` (object)
    An object with three fields.

For a list of used watchlists, see Personator Identity Watchlists.

Example:
"Watchlists": {
  "Hit":"Yes",
  "Sources":
    [{
      "Name":"Specially Designated Nationals OFAC",
      "Code":"",
      "Type":"sanction",
      "Date":""
    },
    {
      "Name":"United Kingdom HM Treasury",
      "Code": "PR",
      "Type": "sanction",
      "Date": "2005-12-07"
    }],
  "Articles":
    [{
      "Title":"SampleTitleName",
      "Link":"http://samplereportlink.com",
      "Date":"2017-09-30T00:00:00Z"
    }],
  }

  - `Identity.Watchlists.Hit` (string)
    Returns a string containing either Yes or No.

  - `Identity.Watchlists.Sources` (array)
    Returns an array of the names of watchlists the individual was found on.

  - `Identity.Watchlists.Sources.Name` (string)
    A string value containing the name of the Watchlist source that was matched.

  - `Identity.Watchlists.Sources.Code` (string)
    A two letter string representing the code attributed to the watchlist source. Premium Watchlist matches will always return PR.

  - `Identity.Watchlists.Sources.Type` (string)
    A string value containing the type or category of Watchlist that was matched against.

  - `Identity.Watchlists.Sources.Date` (string)
    A string value containing the date (YYYY-MM-DD) of when the Watchlist source was created. An empty string will be returned if the source does not have this information.

  - `Identity.Watchlists.Articles` (array)
    Returns the title, link and date of the article.

  - `Identity.Watchlists.Articles.Title` (string)

  - `Identity.Watchlists.Articles.Link` (string)

  - `Identity.Watchlists.Articles.Date` (string)

  - `Identity.Watchlists.ReportLink` (string)

  - `Identity.WatchlistsPersons` (string)
    Blank (Currently reserved for future) - A string value listing the potential names that were found matched on a watchlist.

  - `Name` (object)

  - `Name.Company` (string)
    The standardized company name.

  - `Name.Gender` (string)
    A one-character string value indicating the gender of the first name from the input.

For a list of these codes, see the [Product Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html#personatoridentity-referenceguide-resultcodes-productcodes) list.

  - `Name.Gender2` (string)
    A one-character string value indicating the gender of the inputted full name.

For a list of these codes, see the [Product Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html#personatoridentity-referenceguide-resultcodes-productcodes) list.

If the FullName input property contained multiple names, the gender of the second name will be returned here.

  - `Name.NameFirst` (string)
    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.

  - `Name.NameFirst2` (string)
    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.

  - `Name.NameLast` (string)
    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.

  - `Name.NameLast2` (string)
    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.

  - `Name.NameMiddle` (string)
    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.

  - `Name.NameMiddle2` (string)
    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.

  - `Name.NamePrefix` (string)
    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.

  - `Name.NamePrefix2` (string)
    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.

  - `Name.NameSuffix` (string)
    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.

  - `Name.NameSuffix2` (string)
    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.

  - `Name.Results` (string)
    Comma delimited status, error codes, and change codes for the record.

For a list of these codes, see the [Result Codes](https://docs.melissa.com/cloud-api/personator-identity/result-codes.html) list.

  - `Phone` (object)

  - `Phone.AdministrativeArea` (string)
    State. The administrative area (state) associated with the phone number.

  - `Phone.CallerID` (string)
    The user name associated with the phone number, provided by our Caller ID service.

  - `Phone.Carrier` (string)
    The phone number's carrier name.

  - `Phone.CountryAbbreviation` (string)
    The abbreviation of the country.

  - `Phone.PhoneCountryDialingCode` (string)
    The digit(s) required to reach the target country. These are dialed after the international prefix.

  - `Phone.CountryName` (string)
    The country name associated with the phone number.

  - `Phone.DST` (string)
    Indicates if the phone number region observes daylight savings time. Y for yes or N for no.

  - `Phone.InternationalPhoneNumber` (string)
    The number you dial to successfully send an international call. This number can change depending on the Country of Origin field.

  - `Phone.PhoneInternationalPrefix` (string)
    The international exit code needed to call a number outside of the dialing country. This depends on the Country of Origin and Country input fields.

  - `Phone.Language` (string)
    The predominant language of the phone number's geographical location.

  - `Phone.Latitude` (string)
    The latitude of the phone number's service area. Latitude is measured in degrees north or south of the equator.

  - `Phone.Locality` (string)
    The locality (city) associated with the phone number.

  - `Phone.Longitude` (string)
    The latitude of the phone number's service area. Latitude is measured in degrees east or west of the Greenwich Meridian.

  - `Phone.PhoneNationPrefix` (string)
    The digit(s) dialed before an area (city) code when calling a number within the same country but outside the numbering area.

  - `Phone.PhoneNationalDestinationCode` (string)
    The national destination code, the numbering area within a country (or group of countries) and/or network/services.

  - `Phone.PhoneNumber` (string)
    The standardized phone number. This will return in varying formats depending on the inputs. For more detailed information, see [Phone Number Format](https://docs.melissa.com/cloud-api/global-phone/global-phone-reference-guide.html#globalphone-referenceguide-phonenumberformat).

  - `Phone.PostalCode` (string)
    US Only. The zip code associated with the phone number.

  - `Phone.PhoneSubscriberNumber` (string)
    The significant leading digits that further define the local exchange area and/or service.

  - `Phone.Suggestions` (string)
    An array of Response Record Elements. This is for single-record requests only.

  - `Phone.UTC` (string)
    The phone number's time zone in the format: +/- hh:mm.

  - `Phone.TimeZoneCode` (string)

  - `Phone.TimeZoneName` (string)

## Response 400 fields (application/json):

  - `type` (string)
    The type of error that occurred.

  - `title` (string)
    A short summary of the error.

  - `status` (integer)
    The HTTP status code for the error.

  - `errors` (object)

  - `errors.$.<PropertyName>` (array)
    A detailed message about the error.

  - `traceId` (string)
    A unique identifier for the request, useful for debugging.