Random Name

curl --request GET \
  --url https://api.example.com/v1/random/name \
  --header 'X-API-Key: <api-key>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

random

name

Random Name

curl --request GET \
  --url https://api.example.com/v1/random/name \
  --header 'X-API-Key: <api-key>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

X-API-Key

string

header

required

type

string

default:full

Name type: first, last, full, prefix, suffix

gender

string | null

Gender hint: male, female, or null for random

locale

string | null

Locale (e.g., en_US, es_ES, ja_JP, zh_CN, fr_FR, de_DE)

count

integer

default:1

Number of names to generate

Required range: 1 <= x <= 100

Successful Response