Random User API

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

(4.4)

From 9,002 users

1,600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
293ms331ms368ms590ms965ms

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.

Response

Returns an array of random user objects.

  • id

    Unique user identifier

  • username

    Username

  • password

    Password

  • email

    Email address

  • name

    Full name

  • first_name

    First name

  • last_name

    Last name

  • full_name

    Full name (alternative)

  • prefix

    Prefix, e.g. 'Mr.', 'Ms.' etc.

  • suffix

    Suffix, e.g. 'Jr.', 'PhD'

  • phone

    Phone number

  • cell

    Cell phone number

  • address

    Mailing address

  • street_address

    Street address

  • city

    City

  • state

    State

  • postal_code

    Postal code

  • country

    Country

  • latitude

    Latitude

  • longitude

    Longitude

  • timezone

    Timezone

  • dob

    Date of birth

  • age

    Age

  • gender

    Gender

  • job

    Job title

  • company

    Company name

  • company_email

    Work/company email

  • ssn

    Social security number

  • credit_card

    Credit card number

  • credit_card_provider

    Credit card provider

  • iban

    IBAN

  • ipv4

    IPv4 address

  • ipv6

    IPv6 address

  • mac_address

    MAC address

  • user_agent

    User agent string

  • url

    URL

  • domain

    Domain name

  • picture

    Picture URL

  • avatar

    Avatar URL

  • uuid

    UUID

  • md5

    MD5 hash

  • sha1

    SHA1 hash

  • sha256

    SHA256 hash

  • locale

    Locale code

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

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.