Random UserRandom User Generator
A free API for generating placeholder people — like Lorem Ipsum, but for humans. Unlike the original, this one draws a real place and derives the postcode, dialling code and timezone from it, so a generated address survives the validation a real checkout puts it through.
Clwyd is in Wales. OG is not a postcode area. 016973 is Wigton, Cumbria. And Northern Ireland is not in Indochina.
Shetland contains Lerwick. ZE1 and 01595 both serve it. The clock is the one on the wall there.
Thirteen nationalities ship complete real postcodes. Six more are one command away from the GeoNames export. No more five random digits standing in for a six-digit PIN.
Every landline opens with the real code for that town, with the right subscriber length and local prefix — 0191 3 for Durham, 0191 5 for Sunderland.
City and region are one draw, not two. Curated lists replaced 13,710 unverified place names, and no region can be left without a town.
The offset comes off the record, with per-city exceptions where a zone line cuts through a region — Rapid City runs on Mountain, Ciudad Juárez on El Paso’s clock.
Letters no longer appear inside phone numbers. Eircodes, Dutch postcodes, CEPs and PINs are all the right shape. Landline fields no longer hold mobile numbers.
Values are shaped to survive address validation, so a batch of generated customers loads into a real store and resolves to the right shipping zone.
Street addresses stay generic on purpose — a real street paired with a real postcode would name a real building. Postcode and place data © GeoNames, CC BY 4.0.
You can use AJAX to call the Random User Generator API and will receive a randomly generated user in return. If you are using jQuery, you can use the $.ajax() function in the code snippet below to get started.
$.ajax({
url: 'https://randomuser.mintbin.xyz/api/',
dataType: 'json',
success: function(data) {
console.log(data);
}
});
The application will provide you with a JSON, XML, CSV, or YAML object that you can parse and apply to your application.
You can specify the format you want the results in using the format parameter.
{
"results": [
{
"gender": "female",
"name": {
"title": "Miss",
"first": "Jennie",
"last": "Nichols"
},
"location": {
"street": {
"number": 8929,
"name": "Valwood Pkwy",
},
"city": "Springfield",
"state": "Illinois",
"country": "United States",
"postcode": "62704",
"coordinates": {
"latitude": "-69.8246",
"longitude": "134.8719"
},
"timezone": {
"offset": "-6:00",
"description": "Central Time (US & Canada), Mexico City"
}
},
"email": "jennie.nichols@example.com",
"login": {
"uuid": "7a0eed16-9430-4d68-901f-c0d4c1c3bf00",
"username": "yellowpeacock117",
"password": "addison",
"salt": "sld1yGtd",
"md5": "ab54ac4c0be9480ae8fa5e9e2a5196a3",
"sha1": "edcf2ce613cbdea349133c52dc2f3b83168dc51b",
"sha256": "48df5229235ada28389b91e60a935e4f9b73eb4bdb855ef9258a1751f10bdc5d"
},
"dob": {
"date": "1992-03-08T15:13:16.688Z",
"age": 30
},
"registered": {
"date": "2007-07-09T05:51:59.390Z",
"age": 14
},
"phone": "(217) 561-9542",
"cell": "(217) 304-7718",
"id": {
"name": "SSN",
"value": "405-88-3636"
},
"picture": {
"large": "https://randomuser.mintbin.xyz/api/portraits/men/75.jpg",
"medium": "https://randomuser.mintbin.xyz/api/portraits/med/men/75.jpg",
"thumbnail": "https://randomuser.mintbin.xyz/api/portraits/thumb/men/75.jpg"
},
"nat": "US"
}
],
"info": {
"seed": "56d27f4a53bd5441",
"results": 1,
"page": 1,
"version": "1.4"
}
}
Address coherence is enforced by the test suite, but the world keeps redrawing its own boundaries. If a postcode, dialling code or region looks wrong for its city, it is worth reporting — that is exactly the class of bug this build exists to remove.
↑ ↑ ↓ ↓ ← → ← → B A