Page tree
Skip to end of metadata
Go to start of metadata



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

URL Endpoints


JSON: 

https://trial.serviceobjects.com/NV2/api.svc/NameInfo/{NAME}/{LICENSEKEY}?format=json



XML: 

https://trial.serviceobjects.com/NV2/api.svc/NameInfo?Name={NAME}&LicenseKey={LICENSEKEY}

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/products/demographics-more/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

BestGuessNameNV2NameThe 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.

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.

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.

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.

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.

NameTypeDescription
PrefixStringThe parsed out prefix (Mr, Mrs, etc)
FirstNameStringThe parsed out first name.
MiddleNameStringThe parsed out middle name.
LastNameStringThe parsed out Last Name.
SuffixString

The parsed suffix (Jr, Sr, II, etc)

References

  • No labels