Name

Name-related items.

Optional items are indicated in YELLOW.

First name

Retreive a random first name.

Optionally include the desired sex to receive a female- or male-specific name. Options include female or male.

curl https://api.fakerest.dev/v1/name/firstname

{
  "status": 200,
  "firstName": "Maurice"
}

with optional sex

curl https://api.fakerest.dev/v1/name/firstname/female

{
    "status": 200
    "firstName": "Anabel",
}

Full name

Retreive a random full name, including several options on specifying parts of the name.

Optionally include a first to receive a random name that always starts with the same first name. List it as all if you want it to be random, but also want to specify a parameter later in the url.

Optionally include a last to receive a random name that always ends with the same last name. List it as all if you want it to be random, but also want to specify a parameter later in the url.

Optionally include the desired sex to receive a female- or male-specific name. Options include female or male. Options include female or male.

curl https://api.fakerest.dev/v1/name/fullname

{
  "status": 200,
  "fullName": "Jo Altenwerth"
}

with optional first name

curl https://api.fakerest.dev/v1/name/fullname/Brian

{
  "status": 200,
  "fullName": "Brian Funk"
}

with optional last name and random female first name

curl https://api.fakerest.dev/v1/name/fullname/all/Davis/female

{
  "status": 200,
  "fullName": "Jennifer Davis"
}

Gender

Retreive a random gender.

curl https://api.fakerest.dev/v1/name/gender

{
  "status": 200,
  "gender": "Neutrois"
}

Job area

Retreive a random job area.

curl https://api.fakerest.dev/v1/name/jobarea

{
  "status": 200,
  "jobArea": "Operations"
}

Job descriptor

Retreive a random job descriptor.

curl https://api.fakerest.dev/v1/name/jobdescriptor

{
  "status": 200,
  "jobDescriptor": "Customer"
}

Job title

Retreive a random job title.

curl https://api.fakerest.dev/v1/name/jobtitle

{
  "status": 200,
  "jobTitle": "Chief Configuration Specialist"
}

Job type

Retreive a random job type.

curl https://api.fakerest.dev/v1/name/jobtype

{
  "status": 200,
  "jobType": "Strategist"
}

Last name

Retreive a random last name.

Optionally include the desired sex to receive a female- or male-specific name. Options include female or male.

curl https://api.fakerest.dev/v1/name/lastname

{
  "status": 200,
  "lastName": "Hahn"
}

with optional sex

curl https://api.fakerest.dev/v1/name/lastname/male

{
  "status": 200,
  "lastName": "Towne"
}

Middle name

Retreive a random middle name.

Optionally include the desired sex to receive a female- or male-specific name. Options include female or male.

curl https://api.fakerest.dev/v1/name/middlename

{
  "status": 200,
  "middleName": "Parker"
}

with optional sex

curl https://api.fakerest.dev/v1/name/middlename/female

{
  "status": 200,
  "middleName": "Blaise"
}

Prefix

Retreive a random prefix.

Optionally include the desired sex to receive a female- or male-specific prefix. Options include female or male.

curl https://api.fakerest.dev/v1/name/prefix

{
  "status": 200,
  "prefix": "Mr."
}

with optional sex

curl https://api.fakerest.dev/v1/name/prefix/female

{
  "status": 200,
  "prefix": "Dr."
}