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

URL Endpoints

NameInfo Inputs

NameTypeDescription
NameStringThe name to validate.
LicenseKeyStringYour license key to use the service. Sign up for a free trial key at https://www.serviceobjects.com/products/demographics-more/name-validation

NameInfo Outputs 

NameTypeDescription
BestGuessNameNV2NameThe best guess name if a name was unable to be validated. (NV2Name is defined n the next table)
PrefixStringThe parsed out prefix (Mr, Mrs, etc)
FirstNameStringThe parsed first name.
MiddleNameStringThe parsed middle name.
LastNameStringThe parsed last name
SuffixStringThe parsed suffix (Jr, Sr, II, etc)
FirstNameFoundBoolIs the first name found in existing name tables (True / False)
IsCommonFirstNameBoolIs the first name one of the most common first names in existing data (True / False)
FirstNameOriginStringNational origin of the first name (Old-English, etc)
LastNameFoundBoolIs the last name found in existing name tables (True / False)
IsCommonLastNameBoolIs the last name one of the most common first names in existing data (True / False)
GenderStringThe likely gender of the name (Male, Female, Neutral)
FirstNameAltStringIf more than one first name is found, the second first name (ex: John and Mary Smith)
MiddleNameAltStringIf more than one middle name is found, the second middle name
LastNameAltStringIf more than one last name is found, the second last name
FirstNameAltFoundBoolIs the alternative first name found in existing name tables (True / False)
LastNameAltFoundBoolIs the last name found in existing name tables (True / False)
GenderAltStringIf more than one name is present, the gender of the second name
RelatedNamesStringNames related to the first name (Bill, Billy, Billie, etc)
VulgarityScoreIntA 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.
CelebrityScoreIntA 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.
BogusScoreIntA 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.
GarbageScoreIntA 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.
FirstNameDictionaryScoreIntA 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.
MiddleNameDictionaryScoreIntA 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.
LastNameDictionaryScoreIntA 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.
IsNameGoodStringAn analysis of whether or not the name is valid based on the results of the returned scores (“true”, “false”, or “unknown”)
StatusCodesIntA code indicating penalties or extra information about a given name.
StatusStringA field offering more information about this name. Can contain messages offering suggestions for interpreting the name, etc.
NameTypeDescription
PrefixStringThe parsed out prefix (Mr, Mrs,
etc)
FirstNameStringThe parsed out first name.
MiddleNameStringThe parsed out middle name.
LastNameStringThe parsed out Last Name.
SuffixStringThe parsed suffix (Jr, Sr, II, etc)

References