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.

Language
Click Try It! to start a request and see the response here!