Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Random User API

The Random User API generates fake random user data such as name, email, address, username for placeholders or application testing.

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
272ms318ms372ms695ms953ms

Didn't find what you were looking for? Suggest an improvement

/v2/randomuser GET

https://api.api-ninjas.com/v2/randomuser

Returns fake random user profiles. Supports customizable fields, filtering, and localization.

Parameters

  • count  optional

    Number of users to generate (1-30). Default: 10

  • gender  optional

    Filter by gender: "male", "female", "nonbinary", or "any". Default: "any"

  • min_age  optional

    Minimum age (0-1000). Default: 0

  • max_age  optional

    Maximum age (0-1000). Default: 100

  • locale  optional

    Locale for generating localized data (e.g., "en_US", "de_DE", "fr_FR"). Default: "en_US"

  • fields  optional

    Comma-separated list of fields to include (e.g., "name,email,phone"). If not specified, all available fields are returned.

  • exclude  optional

    Comma-separated list of fields to exclude from the response.

  • seed  optional

    Seed value for reproducible random data generation.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

count
gender
min_age
max_age
locale

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v2/randomuser?count=1

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 { "data": [ { "id": "ca91be7d-590d-487d-890e-5fce1230e71e", "username": "bayers", "password": "J!bBb0WS@h7D", "email": "eric80@example.com", "name": "Renee Hodges", "first_name": "Anna", "last_name": "Boyd", "full_name": "Christine Molina", "prefix": "Ms.", "suffix": "PhD", "phone": "(648)309-6667x7350", "cell": "980.638.1668x1484", "address": "953 Everett Locks Apt. 407, Paulstad, WA 71681", "street_address": "61011 Adam Ville Apt. 459", "city": "West Justinborough", "state": "Louisiana", "postal_code": "55582", "country": "Macao", "latitude": 26.057296, "longitude": -29.357945, "timezone": "Europe/Simferopol", "dob": "1941-12-06", "age": 88, "gender": "nonbinary", "job": "Advertising art director", "company": "Rodriguez-Jones", "company_email": "pconway@stewart-white.info", "ssn": "386-91-0691", "credit_card": "3500864529934943", "credit_card_provider": "Maestro", "iban": "GB42WOZH74182924370603", "ipv4": "57.201.213.61", "ipv6": "986a:fb21:ff0d:f106:c76e:8a9e:3d89:1d4a", "mac_address": "d8:c1:a2:44:e0:ba", "user_agent": "Opera/9.89.(X11; Linux x86_64; os-RU) Presto/2.9.161 Version/11.00", "url": "http://swanson-diaz.com/", "domain": "mcgee.com", "picture": "https://picsum.photos/906/342", "avatar": "https://picsum.photos/200/200", "uuid": "d250e501-50e3-4836-b352-c733ef56306b", "md5": "5b3c2518bd09e8038dc2930435b4107a", "sha1": "4d87d53eda7414a1dad236005511e0540bce2036", "sha256": "83a06e7ba6066fa5f9e111114a2e46eb6572e38a796dda363e003eddead6ebcf", "locale": "fil_PH" } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v2/randomuser?count=1" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.