JSON API

Every generator is also available as a simple GET endpoint. No key is needed. Fair use: up to 120 requests per minute per IP.

GET https://randhome.org/api/v1/us/phones?count=2

{
  "data": [
    { "formatted": "(415) 738-2049", "e164": "+14157382049" },
    { "formatted": "(614) 290-5531", "e164": "+16142905531" }
  ]
}

Countries

Replace us in the path with any of these codes.

usUnited States
caCanada
gbUnited Kingdom *
deGermany
frFrance
esSpain
nlNetherlands
brBrazil
mxMexico

/api/v1/us/identities

Parameters: count (1–100, default 10), seed, gender (any|female|male), region (as for addresses; not GB), type (any|mobile|landline; not US, CA)
Example: /api/v1/us/identities?count=3&gender=female

/api/v1/us/names

Parameters: count (1–100, default 10), seed, gender (any|female|male), rarity (common|any), middle (true|false; US, CA, GB)
Example: /api/v1/us/names?count=3&gender=female

/api/v1/us/first-names

Parameters: count (1–100, default 10), seed, gender, rarity
Example: /api/v1/us/first-names?count=5

/api/v1/us/last-names

Parameters: count (1–100, default 10), seed, rarity
Example: /api/v1/us/last-names?count=5&rarity=any

/api/v1/us/nicknames

Parameters: count (1–100, default 10), seed, style (mixed|words|name|gamer), case (camel|lower|snake), digits
Example: /api/v1/us/nicknames?style=gamer&digits=true

/api/v1/us/phones

Parameters: count (1–100, default 10), seed, format (national|international|e164|digits; dashed|dotted for US, CA), type (any|mobile|landline; not US, CA), area_code (US, CA)
Example: /api/v1/us/phones?count=5&format=e164

/api/v1/us/addresses

Parameters: count (1–100, default 10), seed, region (ISO 3166-2 code without the country prefix: CA, BY, IDF…)
Example: /api/v1/us/addresses?count=5&region=CA