Uses the provided name to return information such as gender, name origin, and validity results.
 

URL Endpoints

NameInfo Inputs

Name Type Description
Name String The name to validate.
LicenseKey String Your license key to use the service. Sign up for a free trial key at https://www.serviceobjects.com/name-validation/

NameInfo Outputs

  • NameInfo 
  • If no errors are encountered a NameInfo element will be returned with the following information. If there is an error, an Error object will be returned (explained in Error Page).
Name Type Description
BestGuessName NV2Name The best guess name if a name was unable to be validated. (NV2Name is defined n the next table)
Prefix String The parsed out prefix (Mr, Mrs, etc)
FirstName String The parsed first name.
MiddleName String The parsed middle name.
LastName String The parsed last name
Suffix String The parsed suffix (Jr, Sr, II, etc)
FirstNameFound Bool Is the first name found in existing name tables (True / False)
IsCommonFirstName Bool Is the first name one of the most common first names in existing data (True / False)
FirstNameOrigin String National origin of the first name (Old-English, etc)
LastNameFound Bool Is the last name found in existing name tables (True / False)
IsCommonLastName Bool Is the last name one of the most common first names in existing data (True / False)
Gender String The likely gender of the name (Male, Female, Neutral)
FirstNameAlt String If more than one first name is found, the second first name (ex: John and Mary Smith)
MiddleNameAlt String If more than one middle name is found, the second middle name
LastNameAlt String If more than one last name is found, the second last name
FirstNameAltFound Bool Is the alternative first name found in existing name tables (True / False)
LastNameAltFound Bool Is the last name found in existing name tables (True / False)
GenderAlt String If more than one name is present, the gender of the second name
RelatedNames String Names related to the first name (Bill, Billy, Billie, etc)
VulgarityScore Int A score ranging from 0 to 5 indicating the likelihood the given name is a vulgar word or phrase. A score of 5 would be very likely and 0 would be not at all likely.
CelebrityScore Int A score ranging from 0 to 5 indicating the likelihood the given name is a celebrity. A score of 5 would be very likely and 0 would be not at all likely.
BogusScore Int A score ranging from 0 to 5 indicating the likelihood the given name is not a name but simply a word or phrase. A score of 5 would be very likely and 0 would be not at all likely.
GarbageScore Int A score ranging from 0 to 5 indicating the likelihood the given name is not a name but rather a series of random letters. A score of 5 would be very likely and 0 would be not at all likely.
FirstNameDictionaryScore Int A score ranging from 0 to 5 indicating the likelihood the given First name is not a name but a dictionary word. E.g., “Car” is strictly a dictionary word, but “Mark” is both a word and a name. A score of 5 would be very likely and 0 would be not at all likely.
MiddleNameDictionaryScore Int A score ranging from 0 to 5 indicating the likelihood the given Middle name is strictly a dictionary word. E.g., “Car” is strictly a dictionary word, but “Mark” is both a word and a name. A score of 5 would be very likely and 0 would be not at all likely.
LastNameDictionaryScore Int A score ranging from 0 to 5 indicating the likelihood the given Last name is strictly a dictionary word. E.g., “Car” is strictly a dictionary word, but “Mark” is both a word and a name. A score of 5 would be very likely and 0 would be not at all likely.
IsNameGood String An analysis of whether or not the name is valid based on the results of the returned scores (“true”, “false”, or “unknown”)
StatusCodes Int A code indicating penalties or extra information about a given name.
Status String A field offering more information about this name. Can contain messages offering suggestions for interpreting the name, etc.
  • NV2Name
  • A structure containing name information in the event a validated name could not be found.
Name Type Description
Prefix String The parsed out prefix (Mr, Mrs,
etc)
FirstName String The parsed out first name.
MiddleName String The parsed out middle name.
LastName String The parsed out Last Name.
Suffix String The parsed suffix (Jr, Sr, II, etc)

References