All caps, all lower, Last, First order, and attached prefixes or suffixes. The parts come back split and proper cased.

Does casing rewrite my data?

Only all-upper or all-lower input is recased. Mixed case passes through, so McIntyre stays McIntyre.

Gender comes from first-name records and answers only when the data decides it. Ambiguous names like Taylor and Jordan return null.

Role words, company markers like LLC, and placeholders like test test. Those answer valid: false as a 200, never a 404.

GET /name/{name}

Name API

Pass a name any way a form gave it to you. Get it back clean.

name

Cleaned full name, comma flip resolved and proper cased

valid

Looks like a person's name. Role words, company markers, and placeholders answer false

first

First name

middle

Middle name or initial, null when absent

last

Last name, name particles included (de la Hoya), null on a single word

prefix

Mr, Mrs, Ms, Dr, Prof, and friends, null when absent

suffix

Jr, III, PhD class, null when absent

gender

male or female from first-name data, null when the name does not decide it

salutation

Mr or Ms from gender, null when gender is null

Pass the mess

All caps, all lower, Last, First order, prefixes and suffixes attached.

Get the parts

First, middle, last, prefix, suffix. Proper cased, first name first.

Junk answers false

Role words, company markers, and placeholders come back valid: false.

57,874 first names.

Gender when the data decides it. Every plan.

57,874
first names with gender: 1880
records back to

Pass a name the way a form field gave it to you. GRACE HOPPER, smith, john, and Dr. Jane Smith Jr. all come back split into first, middle, and last, proper cased, in first-name-first order, with prefix and suffix set aside.

Role words, company markers, and placeholders answer valid: false. Gender comes from official given-name counts back to 1880 and only answers when the data decides it, with a Mr or Ms salutation to match. Ambiguous names return null.

RESPONSE

$ curl "https://api.parseapi.com/name/GRACE%20HOPPER" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~16ms · USA
{
  "name": "Grace Hopper",
  "valid": true,
  "prefix": null,
  "first": "Grace",
  "middle": null,
  "last": "Hopper",
  "suffix": null,
  "gender": "female",
  "salutation": "Ms"
}

Response fields

name: Cleaned full name, comma flip resolved and proper cased
valid: Looks like a person's name. Role words, company markers, and placeholders answer false
prefix: Mr, Mrs, Ms, Dr, Prof, and friends, null when absent
first: First name
middle: Middle name or initial, null when absent
last: Last name, name particles included (de la Hoya), null on a single word
suffix: Jr, III, PhD class, null when absent
gender: male or female from first-name data, null when the name does not decide it
salutation: Mr or Ms from gender, null when gender is null

QUESTIONS

What input works?: All caps, all lower, Last, First order, and attached prefixes or suffixes. The parts come back split and proper cased.
Does casing rewrite my data?: Only all-upper or all-lower input is recased. Mixed case passes through, so McIntyre stays McIntyre.
When is gender null?: Gender comes from first-name records and answers only when the data decides it. Ambiguous names like Taylor and Jordan return null.
What counts as junk?: Role words, company markers like LLC, and placeholders like test test. Those answer valid: false as a 200, never a 404.

SPEED

How long a lookup takes.

16ms

17ms

APAC

59ms

LatAm

19ms

126ms

See live status →

Coverage

Official given-name counts back to 1880. Gender only when the data decides it.

Create a free key Docs