Random User Generator

Generate invented people for testing, from a service that has been handing them out free since 2013. A person comes with a name, a gender, an email address, a postal address with coordinates and a time zone, phone and mobile numbers, a date of birth, a login with salted MD5, SHA-1 and SHA-256 hashes, a national ID number and a portrait photo. Ask for one or for five thousand, from any of twenty-one countries, and the names, addresses, phone numbers and ID numbers are written the way that country writes them. Give it a seed and the same people come back every time, which is what makes a test fixture worth keeping. Narrower actions return just names, just addresses, just logins or just passwords, and an export action hands back CSV, JSON, XML or YAML ready to write to a file. Nobody generated here is real and every email address is at example.com, which can never receive mail. Every action reads: nothing here changes anything, at the service or anywhere else. No account or API key required.

Actions

Action	What it does
Export users to a file	Generate people and get the service's own CSV, JSON, XML or YAML rendering of them as a file you can download, attach to an email or hand to an import tool.
Generate addresses	Generate invented postal addresses: street, city, state, postcode, country, latitude and longitude, and a time zone.
Generate logins	Generate sign-in credentials for testing: a username, a password, the MD5, SHA-1 and SHA-256 hashes of that password with its salt, a UUID, and the name and email address they belong to.
Generate names	Generate a list of invented people's names and nothing else: title, first name, last name, gender and nationality.
Generate one user	Generate exactly one invented person, returned on its own rather than inside a list, so a later step can read 'user.email' without picking an item out of an array.
Generate passwords	Generate a list of passwords and nothing else, built from the character sets and length you choose.
Generate users	Generate a batch of invented people for testing: name, gender, email, address, coordinates, time zone, phone and mobile numbers, date of birth, a login with password hashes, a national ID number and portrait photo URLs.
List nationalities	List the twenty-one countries this integration can generate people from, with what each one yields: the national ID number it issues, or that it issues none, and what its postcodes look like.

Export users to a file

Generate people and get the service's own CSV, JSON, XML or YAML rendering of them as a file you can download, attach to an email or hand to an import tool. This is the one action that returns the service's own field names rather than the tidied ones the other actions use, because an export is meant to be read by something else, and the one that hands back a file rather than data: 5,000 people is several megabytes, so the file is stored and only its opening lines come back inline. A seed is chosen for you when you do not give one, and reported, so any export can be produced again. No API key required.

Inputs

How many peoplecountnumber: How many people to put in the file, from 1 to 5,000.From 1 to 5000. Default: 100.
File formatexport_formattext: How to render the people. CSV is one row each and opens in a spreadsheet, but it is the only format that drops the seed from the file, which is why a seed is always chosen and reported separately. Whichever you pick, the result is a file to download rather than text in the step.One of: csv (CSV: one row per person, for a spreadsheet), json (JSON: compact, on one line), pretty (JSON, indented to be read), xml, yaml. Default: csv.
Gendergendertext: Whether to draw only women, only men, or whichever comes up. This cannot be combined with a seed: the service silently ignores the gender whenever a seed is set, so asking for both fails the step rather than quietly returning a mix.One of: any (Either, whichever comes up), female (Women only), male (Men only). Default: any.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.
Only these fieldsinclude_fieldslist: Which parts of a person to return. Leave empty for all of them. Narrowing this is worth doing for a large batch: the login hashes are the expensive part to generate. The nationality always comes back, whatever is chosen here. Use this or 'Leave out these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).
Leave out these fieldsexclude_fieldslist: Which parts of a person to drop. Leave empty to keep everything. Handy for trimming a batch down to what a fixture actually needs. Use this or 'Only these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).

Outputs

byte_sizenumber
charactersnumber
content_typetext
countnumber
document_reftext
documentslist
fieldslist
filenametext
formattext
gendertext
nationalitieslist
pagenumber
previewtext
seedtext
urltext
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "byte_size": 151,
  "characters": 151,
  "content_type": "text/csv",
  "count": 2,
  "document_ref": "doc_9f2c41a7b83e40d1",
  "documents": [
    {
      "content_type": "text/csv",
      "document_ref": "doc_9f2c41a7b83e40d1",
      "filename": "random-users.csv",
      "size_bytes": 151,
      "url": "/actions/core/serve-document/doc_9f2c41a7b83e40d1"
    }
  ],
  "fields": [
    "gender",
    "name",
    "email",
    "nat"
  ],
  "filename": "random-users.csv",
  "format": "csv",
  "gender": "any",
  "nationalities": [
    "US"
  ],
  "page": 1,
  "preview": "gender,name.title,name.first,name.last,email,nat\nfemale,Miss,Jennie,Nichols,jennie.nichols@example.com,US\nmale,Mr,Ross,Ramos,ross.ramos@example.com,US",
  "seed": "a3f19c04b7e2d581",
  "url": "/actions/core/serve-document/doc_9f2c41a7b83e40d1",
  "version": "1.4",
  "warnings": []
}

Generate addresses

Generate invented postal addresses: street, city, state, postcode, country, latitude and longitude, and a time zone. Each address is written the way its country writes one, and comes with a ready-made single-line version for a label or an email. Use it to test an address form, a shipping calculator or a map pin. The coordinates are random rather than anywhere near the address, so treat them as two separate test values. No API key required.

Inputs

How many addressescountnumber: How many addresses to generate, from 1 to 5,000.From 1 to 5000. Default: 10.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.

Outputs

addresseslist
countnumber
nationalitieslist
pagenumber
seedtext
urltext
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "addresses": [
    {
      "address": "8929 Valwood Pkwy, Billings, Michigan 63104, United States",
      "city": "Billings",
      "country": "United States",
      "latitude": -69.8246,
      "longitude": 134.8719,
      "nationality": "US",
      "nationality_name": "United States",
      "postcode": "63104",
      "state": "Michigan",
      "street": "8929 Valwood Pkwy",
      "street_name": "Valwood Pkwy",
      "street_number": "8929",
      "timezone_description": "Adelaide, Darwin",
      "timezone_offset": "+9:30"
    }
  ],
  "count": 1,
  "nationalities": [
    "US"
  ],
  "page": 1,
  "seed": "staging-fixtures",
  "url": "https://randomuser.me/",
  "version": "1.4",
  "warnings": []
}

Generate logins

Generate sign-in credentials for testing: a username, a password, the MD5, SHA-1 and SHA-256 hashes of that password with its salt, a UUID, and the name and email address they belong to. Choose which characters the passwords use and how long they run, or leave that empty to get real, commonly used passwords instead, which is the better fixture for testing a strength check. Every address is at example.com and cannot receive mail. No API key required.

Inputs

How many loginscountnumber: How many logins to generate, from 1 to 5,000. The hashes are the slowest thing the service computes, so a batch in the thousands takes a moment.From 1 to 5000. Default: 10.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.
Password characterspassword_charsetslist: Which kinds of character the passwords may use. Choose several to mix them. Leave empty and the passwords are drawn instead from the service's list of about ten thousand real, commonly used passwords, which is the more realistic fixture for testing a password strength check. The length below only applies when at least one of these is chosen.One or more of: special (Punctuation and symbols: !"#$%&'()*+,-./), upper (Capital letters: A to Z), lower (Small letters: a to z), number (Digits: 0 to 9).
Shortest passwordpassword_min_lengthnumber: The fewest characters a password may have, from 1 to 64. Set this and the longest to the same number for passwords of one exact length. Only applies when a character set is chosen above.From 1 to 64. Default: 8.
Longest passwordpassword_max_lengthnumber: The most characters a password may have, from 1 to 64. The service silently substitutes its own bounds for anything outside that, so a number out of range fails the step here instead. Only applies when a character set is chosen above.From 1 to 64. Default: 64.

Outputs

countnumber
duplicate_emailsnumber
duplicate_usernamesnumber
loginslist
nationalitieslist
pagenumber
password_ruleobject
seedtext
urltext
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "count": 1,
  "duplicate_emails": 0,
  "duplicate_usernames": 0,
  "logins": [
    {
      "email": "jennie.nichols@example.com",
      "first_name": "Jennie",
      "full_name": "Jennie Nichols",
      "last_name": "Nichols",
      "md5": "ab54ac4c0be9480ae8fa5e9e2a5196a3",
      "nationality": "US",
      "nationality_name": "United States",
      "password": "Xk4rT9wQz2Lm",
      "salt": "sld1yGtd",
      "sha1": "edcf2ce613cbdea349133c52dc2f3b83168dc51b",
      "sha256": "48df5229235ada28389b91e60a935e4f9b73eb4bdb855ef9258a1751f10bdc5d",
      "title": "Miss",
      "username": "yellowpeacock117",
      "uuid": "7a0eed16-9430-4d68-901f-c0d4c1c3bf00"
    }
  ],
  "nationalities": [
    "US"
  ],
  "page": 1,
  "password_rule": {
    "alphabet_size": 62,
    "charsets": [
      "upper",
      "lower",
      "number"
    ],
    "max_length": 16,
    "min_length": 12,
    "source": "charsets"
  },
  "seed": "staging-fixtures",
  "url": "https://randomuser.me/",
  "version": "1.4",
  "warnings": []
}

Generate names

Generate a list of invented people's names and nothing else: title, first name, last name, gender and nationality. Names are drawn from real name lists for each country, so a French batch reads French and a Serbian one reads Serbian. This is the fastest of the actions here because the service skips generating everything else. Use it for filling a leaderboard mockup, naming test accounts, or checking that a form copes with names outside your own alphabet. No API key required.

Inputs

How many namescountnumber: How many names to generate, from 1 to 5,000. Names are cheap: this is the action to ask for a large batch from.From 1 to 5000. Default: 10.
Gendergendertext: Whether to draw only women, only men, or whichever comes up. This cannot be combined with a seed: the service silently ignores the gender whenever a seed is set, so asking for both fails the step rather than quietly returning a mix.One of: any (Either, whichever comes up), female (Women only), male (Men only). Default: any.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.

Outputs

countnumber
duplicate_namesnumber
gendertext
nationalitieslist
pagenumber
peoplelist
seedtext
urltext
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "count": 1,
  "duplicate_names": 0,
  "gender": "any",
  "nationalities": [
    "US"
  ],
  "page": 1,
  "people": [
    {
      "first_name": "Jennie",
      "full_name": "Jennie Nichols",
      "gender": "female",
      "last_name": "Nichols",
      "nationality": "US",
      "nationality_name": "United States",
      "title": "Miss"
    }
  ],
  "seed": "staging-fixtures",
  "url": "https://randomuser.me/",
  "version": "1.4",
  "warnings": []
}

Generate one user

Generate exactly one invented person, returned on its own rather than inside a list, so a later step can read 'user.email' without picking an item out of an array. The same knobs as the batch action, minus the count and the page. Use this for filling in a single form, addressing a test email, or putting a plausible name on a demo screen. No API key required.

Inputs

Gendergendertext: Whether to draw only women, only men, or whichever comes up. This cannot be combined with a seed: the service silently ignores the gender whenever a seed is set, so asking for both fails the step rather than quietly returning a mix.One of: any (Either, whichever comes up), female (Women only), male (Men only). Default: any.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Only these fieldsinclude_fieldslist: Which parts of a person to return. Leave empty for all of them. Narrowing this is worth doing for a large batch: the login hashes are the expensive part to generate. The nationality always comes back, whatever is chosen here. Use this or 'Leave out these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).
Leave out these fieldsexclude_fieldslist: Which parts of a person to drop. Leave empty to keep everything. Handy for trimming a batch down to what a fixture actually needs. Use this or 'Only these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).

Outputs

fieldslist
gendertext
nationalitieslist
pagenumber
seedtext
urltext
userobject
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "fields": [
    "gender",
    "name",
    "location",
    "email",
    "login",
    "registered",
    "dob",
    "phone",
    "cell",
    "id",
    "picture",
    "nat"
  ],
  "gender": "any",
  "nationalities": [
    "US"
  ],
  "page": 1,
  "seed": "staging-fixtures",
  "url": "https://randomuser.me/",
  "user": {
    "address": "8929 Valwood Pkwy, Billings, Michigan 63104, United States",
    "age": 34,
    "cell": "(489) 330-2385",
    "city": "Billings",
    "country": "United States",
    "date_of_birth": "1992-03-08T15:13:16.688Z",
    "email": "jennie.nichols@example.com",
    "first_name": "Jennie",
    "full_name": "Jennie Nichols",
    "gender": "female",
    "id_name": "SSN",
    "id_value": "405-88-3636",
    "last_name": "Nichols",
    "latitude": -69.8246,
    "longitude": 134.8719,
    "md5": "ab54ac4c0be9480ae8fa5e9e2a5196a3",
    "nationality": "US",
    "nationality_name": "United States",
    "password": "addison",
    "phone": "(272) 790-0888",
    "picture_large": "https://randomuser.me/api/portraits/women/75.jpg",
    "picture_medium": "https://randomuser.me/api/portraits/med/women/75.jpg",
    "picture_thumbnail": "https://randomuser.me/api/portraits/thumb/women/75.jpg",
    "postcode": "63104",
    "registered_date": "2007-07-09T05:51:59.390Z",
    "registered_years": 19,
    "salt": "sld1yGtd",
    "sha1": "edcf2ce613cbdea349133c52dc2f3b83168dc51b",
    "sha256": "48df5229235ada28389b91e60a935e4f9b73eb4bdb855ef9258a1751f10bdc5d",
    "state": "Michigan",
    "street": "8929 Valwood Pkwy",
    "street_name": "Valwood Pkwy",
    "street_number": "8929",
    "timezone_description": "Adelaide, Darwin",
    "timezone_offset": "+9:30",
    "title": "Miss",
    "username": "yellowpeacock117",
    "uuid": "7a0eed16-9430-4d68-901f-c0d4c1c3bf00"
  },
  "version": "1.4",
  "warnings": []
}

Generate passwords

Generate a list of passwords and nothing else, built from the character sets and length you choose. Leave the character sets empty and you get real passwords from the service's list of about ten thousand commonly used ones instead, which is what to test a password blocklist or a strength meter against. The result reports the shortest and longest it produced, so you can see the rule took. No API key required.

Inputs

How many passwordscountnumber: How many passwords to generate, from 1 to 5,000.From 1 to 5000. Default: 10.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.
Password characterspassword_charsetslist: Which kinds of character the passwords may use. Choose several to mix them. Leave empty and the passwords are drawn instead from the service's list of about ten thousand real, commonly used passwords, which is the more realistic fixture for testing a password strength check. The length below only applies when at least one of these is chosen.One or more of: special (Punctuation and symbols: !"#$%&'()*+,-./), upper (Capital letters: A to Z), lower (Small letters: a to z), number (Digits: 0 to 9).
Shortest passwordpassword_min_lengthnumber: The fewest characters a password may have, from 1 to 64. Set this and the longest to the same number for passwords of one exact length. Only applies when a character set is chosen above.From 1 to 64. Default: 8.
Longest passwordpassword_max_lengthnumber: The most characters a password may have, from 1 to 64. The service silently substitutes its own bounds for anything outside that, so a number out of range fails the step here instead. Only applies when a character set is chosen above.From 1 to 64. Default: 64.

Outputs

countnumber
duplicate_passwordsnumber
longestnumber
pagenumber
password_ruleobject
passwordslist
seedtext
shortestnumber
urltext
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "count": 3,
  "duplicate_passwords": 0,
  "longest": 16,
  "page": 1,
  "password_rule": {
    "alphabet_size": 95,
    "charsets": [
      "special",
      "upper",
      "lower",
      "number"
    ],
    "max_length": 16,
    "min_length": 16,
    "source": "charsets"
  },
  "passwords": [
    "5Hq!vTn2@Rk8wZ*c",
    "Jb#4mXe7Ld$9pQr1",
    "wY6&tKa3Nu%8Cs2V"
  ],
  "seed": "staging-fixtures",
  "shortest": 16,
  "url": "https://randomuser.me/",
  "version": "1.4",
  "warnings": []
}

Generate users

Generate a batch of invented people for testing: name, gender, email, address, coordinates, time zone, phone and mobile numbers, date of birth, a login with password hashes, a national ID number and portrait photo URLs. Nobody here is real and no email address can receive mail, so this is safe to seed a staging database with. Give it a seed and the same people come back every time. Ask for up to 5,000 at once. No API key required.

Inputs

How many peoplecountnumber: How many people to generate, from 1 to 5,000. The service answers a number outside that with a single person and no explanation, so this fails the step instead.From 1 to 5000. Default: 10.
Gendergendertext: Whether to draw only women, only men, or whichever comes up. This cannot be combined with a seed: the service silently ignores the gender whenever a seed is set, so asking for both fails the step rather than quietly returning a mix.One of: any (Either, whichever comes up), female (Women only), male (Men only). Default: any.
Nationalitiesnationalitieslist: Which countries the people should come from. Choose several and each person is drawn from one of them. Leave empty for all twenty-one. This decides the names, the address format, the phone numbers and the national ID number, but not the portraits, which are the same set for every country. Run 'List nationalities' to see what each one yields.One or more of: AU (AU: Australia), BR (BR: Brazil), CA (CA: Canada), CH (CH: Switzerland), DE (DE: Germany), DK (DK: Denmark), ES (ES: Spain), FI (FI: Finland), FR (FR: France), GB (GB: United Kingdom), and 11 more.
Seedseedtext: Any text. The same seed returns the same people every time, which is what makes a test fixture worth having. Leave empty and the service picks one and reports it back, so a run can be repeated afterwards. Avoid a seed of exactly 18 characters: that length has a special meaning to the service and is refused here.
Pagepagenumber: Which draw of the seed to take. Page 2 of a seed is a different set of people from page 1, not the next slice of one long list, so pages can overlap and cannot be stitched together into a bigger set. Use it to get more people from the same seed without changing the seed.From 1 to 10000. Default: 1.
Only these fieldsinclude_fieldslist: Which parts of a person to return. Leave empty for all of them. Narrowing this is worth doing for a large batch: the login hashes are the expensive part to generate. The nationality always comes back, whatever is chosen here. Use this or 'Leave out these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).
Leave out these fieldsexclude_fieldslist: Which parts of a person to drop. Leave empty to keep everything. Handy for trimming a batch down to what a fixture actually needs. Use this or 'Only these fields', not both.One or more of: gender, name (Name: title, first and last), location (Location: address, coordinates, time zone), email (Email address), login (Login: username, password, UUID and hashes), registered (Registration date), dob (Date of birth and age), phone (Landline number), cell (Mobile number), id (National ID number), picture (Portrait photo URLs), nat (Nationality).

Outputs

countnumber
duplicate_emailsnumber
duplicate_usernamesnumber
fieldslist
gendertext
nationalitieslist
pagenumber
seedtext
urltext
userslist
versiontext
warningslist: Anything worth knowing about this draw that did not stop it: a seed overriding the nationalities, or a batch large enough that portraits repeat.

Example output

{
  "count": 1,
  "duplicate_emails": 0,
  "duplicate_usernames": 0,
  "fields": [
    "gender",
    "name",
    "location",
    "email",
    "login",
    "registered",
    "dob",
    "phone",
    "cell",
    "id",
    "picture",
    "nat"
  ],
  "gender": "any",
  "nationalities": [
    "US"
  ],
  "page": 1,
  "seed": "staging-fixtures",
  "url": "https://randomuser.me/",
  "users": [
    {
      "address": "8929 Valwood Pkwy, Billings, Michigan 63104, United States",
      "age": 34,
      "cell": "(489) 330-2385",
      "city": "Billings",
      "country": "United States",
      "date_of_birth": "1992-03-08T15:13:16.688Z",
      "email": "jennie.nichols@example.com",
      "first_name": "Jennie",
      "full_name": "Jennie Nichols",
      "gender": "female",
      "id_name": "SSN",
      "id_value": "405-88-3636",
      "last_name": "Nichols",
      "latitude": -69.8246,
      "longitude": 134.8719,
      "md5": "ab54ac4c0be9480ae8fa5e9e2a5196a3",
      "nationality": "US",
      "nationality_name": "United States",
      "password": "addison",
      "phone": "(272) 790-0888",
      "picture_large": "https://randomuser.me/api/portraits/women/75.jpg",
      "picture_medium": "https://randomuser.me/api/portraits/med/women/75.jpg",
      "picture_thumbnail": "https://randomuser.me/api/portraits/thumb/women/75.jpg",
      "postcode": "63104",
      "registered_date": "2007-07-09T05:51:59.390Z",
      "registered_years": 19,
      "salt": "sld1yGtd",
      "sha1": "edcf2ce613cbdea349133c52dc2f3b83168dc51b",
      "sha256": "48df5229235ada28389b91e60a935e4f9b73eb4bdb855ef9258a1751f10bdc5d",
      "state": "Michigan",
      "street": "8929 Valwood Pkwy",
      "street_name": "Valwood Pkwy",
      "street_number": "8929",
      "timezone_description": "Adelaide, Darwin",
      "timezone_offset": "+9:30",
      "title": "Miss",
      "username": "yellowpeacock117",
      "uuid": "7a0eed16-9430-4d68-901f-c0d4c1c3bf00"
    }
  ],
  "version": "1.4",
  "warnings": []
}

List nationalities

List the twenty-one countries this integration can generate people from, with what each one yields: the national ID number it issues, or that it issues none, and what its postcodes look like. Worth reading before building a fixture on the assumption that everyone has an ID number: Iran, New Zealand, Turkey and Ukraine have none. This answers from what the pinned version of the service carries, so it costs no request and always works. No API key required.

Inputs

None.

Outputs

countnumber
nationalitieslist
urltext
versiontext
without_national_idlist

Example output

{
  "count": 21,
  "nationalities": [
    {
      "code": "AU",
      "country": "Australia",
      "has_national_id": true,
      "id_name": "TFN",
      "postcode_format": "three or four digits, 200 to 9999",
      "postcode_is_digits_only": true
    },
    {
      "code": "GB",
      "country": "United Kingdom",
      "has_national_id": true,
      "id_name": "NINO",
      "postcode_format": "a UK-style postcode, such as EC1A 1BB",
      "postcode_is_digits_only": false
    },
    {
      "code": "NZ",
      "country": "New Zealand",
      "has_national_id": false,
      "id_name": "",
      "postcode_format": "five digits, 10000 to 99999",
      "postcode_is_digits_only": true
    }
  ],
  "url": "https://randomuser.me/documentation",
  "version": "1.4",
  "without_national_id": [
    "IR",
    "NZ",
    "TR",
    "UA"
  ]
}

Random User Generator

ActionsCopy Anchor Link

Export users to a fileCopy Anchor Link

Inputs

Outputs

Generate addressesCopy Anchor Link

Inputs

Outputs

Generate loginsCopy Anchor Link

Inputs

Outputs

Generate namesCopy Anchor Link

Inputs

Outputs

Generate one userCopy Anchor Link

Inputs

Outputs

Generate passwordsCopy Anchor Link

Inputs

Outputs

Generate usersCopy Anchor Link

Inputs

Outputs

List nationalitiesCopy Anchor Link

Inputs

Outputs

On this page

Actions

Export users to a file

Generate addresses

Generate logins

Generate names

Generate one user

Generate passwords

Generate users

List nationalities