Random User Generator API

Field note

What it does

Random User Generator | Documentation Home User Photos Documentation Change Log Stats & Graphs Donate Copyright Notice Photoshop Extension Sketch Extension --> Documentation Documentation for the Random User Generator API Follow us @randomapi Introduction How to use Results Error Handling Requesting multiple users Specifying a gender Passwords Seeds Formats Versioning Nationalities Pagination Including/Excluding fields Miscellaneous Introduction In August 2013, we set out with a goal to create a free and easy to use service to generate random user data for application testing. How to use 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.me/api/ ', dataType: ' json ', success: function( data ) { console.log( data ); } }); Results The API will provide you with a formatted object of your choice that you can parse and apply to your application. JSON is the default format. You can request a different format using the format parameter . { "results": [ { "gender": " female ", "name": { "title": " Miss ", "first": " Jennie ", "last": " Nichols " }, "location": { "street": { "number": 8929 , "name": " Valwood Pkwy ", }, "city": " Billings ", "state": " Michigan ", "country": " United States ", "postcode": " 63104 ", "coordinates": { "latitude": " -69.8246 ", "longitude": " 134.8719 " }, "timezone": { "offset": " +9:30 ", "description": " Adelaide, Darwin " } }, "email": " [email protected] ", "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": " (272) 790-0888 ", "cell": " (489) 330-2385 ", "id": { "name": " SSN ", "value": " 405-88-3636 " }, "picture": { "large": " https://randomuser.me/api/portraits/men/75.jpg ", "medium": " https://randomuser.me/api/portraits/med/men/75.jpg ", "thumbnail": " https://randomuser.me/api/portraits/thumb/men/75.jpg " }, "nat": " US " } ], "info": { "seed": " 56d27f4a53bd5441 ", "results": 1 , "page": 1 , "version": " 1.4 " } } API Errors If our API service is offline or if we are experiencing server issues, we'll return a simple JSON object with an error. { error: "Uh oh, something has gone wrong.

Capabilities

Available capabilities

Tags

Tags

Ways to use it

Ways to use it