Skip to main content
GET
/
v1
/
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>"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
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

Response

Successful Response