Parse a single input string (containing up to two full names) into their individual first name, middle name, and last name components.
The returned object appends gender to each name set. It also identifies business names, nuisance names, and profanity. It detects multiple first names and multiple last names, and verifies commonality of first name and last name.
The service will also fix transposed names. If you pass in "SMITH JOHN", "JOHN SMITH" or "SMITH, JOHN", the response will always be firstname=JOHN, lastname=SMITH.
Making a Request
ValidateName leverages the same low level search functions and data sources used in our Batch Validate Name service. Pass on or two full names to parse into first, middle, and last names. Codes are also returns to indicate various secondary characteristics and errors (see below).
HTTP Headers
The "content-type" in the HTTP header must be set to "application/json", otherwise an HTTP 400 Bad Request response will be returned.
NameResult
Each name passed is returned parsed into distinct first, middle, and last name, as data is available. If request contains two names then two separate sets of names and gender are returned. The appropriate parsing and validation codes are returned as an array.
| Field name | Type | Description |
|---|---|---|
| FirstName1 | string | Parsed first name |
| MiddleName1 | string | Parsed middle name |
| LastName1 | string | Parsed last name |
| FirstName2 | string | Parsed first name |
| MiddleName2 | string | Parsed middle name |
| LastName2 | string | Parsed last name |
| Codes | array | Parsing and validation results. See Status codes. |
Name Status Codes
The following status codes are returned for the ValidateName method
| Code | Description |
|---|---|
| N1 | Parsing successful |
| N2 | Parsing error |
| N3 | FirstName1 had its spelling corrected |
| N4 | FirstName2 had its spelling corrected |
| N5 | FirstName1 was found in the first name lookup table |
| N6 | LastName1 was found in the last name lookup database |
| N7 | FirstName2 was found in the first name lookup database |
| N8 | LastName2 was found in the last name lookup database |
Data Error Codes
The following codes indicate specific issues with your name data.
| Code | Description |
|---|---|
| N9 | Unrecognized name format |
| N10 | Multiple first names detected |
| N11 | Vulgarity detected |
| N12 | Suspicious word detected |
| N13 | Business name detected |
| N14 | Non-alphabetic character detected Name contains a number, punctuation, or control character. |
HTTP Error Messages
Click to see a complete listing of error messages and codes.