Random User API logo
ToolsMAINTAINED1 token / call

Random User API

Realistic fake users for ten countries, internally consistent and seedable, never real people

Generate realistic, fully coherent fake users for demos, mockups, load tests and seeded test fixtures — never real people. Ten nationalities (US, CA, GB, AU, DE, FR, ES, NL, IE, NZ), each internally consistent: a German user gets a German name, a real German city with correct coordinates and timezone, a German street, postcode and phone format; a Canadian gets an A1A 1A1 postcode. Every user carries title and full name, gender, email on RFC-2606 reserved domains (can never reach a real inbox), username, login block with memorable password and UUID, landline and mobile in national formats, full address with coordinates and IANA timezone, date of birth and age, registration date, and avatar image URLs in three sizes. Request up to 100 users per call, restrict nationalities with nat=DE,FR, force gender, and — the killer feature for tests — pass seed=anything to get byte-identical reproducible output on every call. No database, no state, no third-party calls at request time.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

No credit card requiredAccess to 125+ APIsCancel anytime
response.json
{
  "count": 1,
  "seed": "demo",
  "results": [
    {
      "gender": "male",
      "nat": "DE",
      "name": {
        "title": "Mr",
        "first": "Leon",
        "last": "Neumann",
        "full": "Leon Neumann"
      },
      "email": "leon.neumann@example.com",
      "username": "leonneumann2174",
      "login": {
        "username": "leonneumann2174",
        "password": "silent-canyon-57",
        "uuid": "b0e45204-62b1-43cc-9cf2-3b8c9ec9fc7b"
      },
      "phone": "005 08381957",
      "cell": "0154 2375314",
      "location": {
        "street": "8309 Hauptstraße",
        "city": "Berlin",
        "state": "Berlin",
        "postcode": "24061",
        "country": "Germany",
        "coordinates": {
          "latitude": 52.4806,
          "longitude": 13.4263
        },
        "timezone": "Europe/Berlin"
      },
      "dob": {
        "date": "1955-09-23",
        "age": 71
      },
      "registered": {
        "date": "2026-06-14"
      },
      "picture": {
        "large": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=256",
        "medium": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=128",
        "thumbnail": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=64"
      },
      "uuid": "c80f34c1-f3cc-4574-8a5f-2262823d67a0"
    }
  ]
}
Production Ready
Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration
Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs
Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Random User API

  • Populate demos, mockups and screenshots with believable users instead of 'John Doe'.

  • Seed test databases with reproducible fixtures using a seed string.

  • Load-test signup and profile flows with varied, valid-looking data.

  • Generate localized sample data for each market you support.

Random User API endpoints

Every endpoint with its parameters and a real example response.

GETGenerate Random Users

https://api-random-user.dataandapis.com/v1/user

Query parameters

ParameterExample
count5Optional
genderfemaleOptional
natDE,FROptional
seeddemoOptional

Example request

curl "https://api-random-user.dataandapis.com/v1/user?count=5&gender=female&nat=DE%2CFR&seed=demo" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "count": 1,
  "seed": "demo",
  "results": [
    {
      "gender": "male",
      "nat": "DE",
      "name": {
        "title": "Mr",
        "first": "Leon",
        "last": "Neumann",
        "full": "Leon Neumann"
      },
      "email": "leon.neumann@example.com",
      "username": "leonneumann2174",
      "login": {
        "username": "leonneumann2174",
        "password": "silent-canyon-57",
        "uuid": "b0e45204-62b1-43cc-9cf2-3b8c9ec9fc7b"
      },
      "phone": "005 08381957",
      "cell": "0154 2375314",
      "location": {
        "street": "8309 Hauptstraße",
        "city": "Berlin",
        "state": "Berlin",
        "postcode": "24061",
        "country": "Germany",
…
Show full response
{
  "count": 1,
  "seed": "demo",
  "results": [
    {
      "gender": "male",
      "nat": "DE",
      "name": {
        "title": "Mr",
        "first": "Leon",
        "last": "Neumann",
        "full": "Leon Neumann"
      },
      "email": "leon.neumann@example.com",
      "username": "leonneumann2174",
      "login": {
        "username": "leonneumann2174",
        "password": "silent-canyon-57",
        "uuid": "b0e45204-62b1-43cc-9cf2-3b8c9ec9fc7b"
      },
      "phone": "005 08381957",
      "cell": "0154 2375314",
      "location": {
        "street": "8309 Hauptstraße",
        "city": "Berlin",
        "state": "Berlin",
        "postcode": "24061",
        "country": "Germany",
        "coordinates": {
          "latitude": 52.4806,
          "longitude": 13.4263
        },
        "timezone": "Europe/Berlin"
      },
      "dob": {
        "date": "1955-09-23",
        "age": 71
      },
      "registered": {
        "date": "2026-06-14"
      },
      "picture": {
        "large": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=256",
        "medium": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=128",
        "thumbnail": "https://api.dicebear.com/9.x/avataaars/svg?seed=leonneumann2174&size=64"
      },
      "uuid": "c80f34c1-f3cc-4574-8a5f-2262823d67a0"
    }
  ]
}

GETList Nationalities

https://api-random-user.dataandapis.com/v1/user/nationalities

This endpoint takes no parameters.

Example request

curl "https://api-random-user.dataandapis.com/v1/user/nationalities" \
  -H "X-Api-Key: YOUR_API_KEY"
Example response
{
  "count": 10,
  "nationalities": [
    {
      "code": "US",
      "country": "United States"
    },
    {
      "code": "CA",
      "country": "Canada"
    },
    {
      "code": "GB",
      "country": "United Kingdom"
    },
    {
      "code": "AU",
      "country": "Australia"
    },
    {
      "code": "DE",
      "country": "Germany"
    },
    {
      "code": "FR",
      "country": "France"
    },
    {
…
Show full response
{
  "count": 10,
  "nationalities": [
    {
      "code": "US",
      "country": "United States"
    },
    {
      "code": "CA",
      "country": "Canada"
    },
    {
      "code": "GB",
      "country": "United Kingdom"
    },
    {
      "code": "AU",
      "country": "Australia"
    },
    {
      "code": "DE",
      "country": "Germany"
    },
    {
      "code": "FR",
      "country": "France"
    },
    {
      "code": "ES",
      "country": "Spain"
    },
    {
      "code": "NL",
      "country": "Netherlands"
    },
    {
      "code": "IE",
      "country": "Ireland"
    },
    {
      "code": "NZ",
      "country": "New Zealand"
    }
  ]
}

Where the data comes from

Source
Generated in the worker from bundled name, place and format pools per nationality.
Freshness
Generated on every call; deterministic with a seed.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages
2endpoints
RESTarchitecture
1key for all APIs
  • Fully typed responses — auto-completion in your IDE
  • Tracks the API in lockstep — new endpoints land same day
  • One key works across 125+ APIs on the platform
import axios from 'axios';

const { data } = await axios.get(
  'https://api-random-user.dataandapis.com/v1/user',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Random User API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Query Parameters

count(Optional)
gender(Optional)
nat(Optional)
seed(Optional)
import axios from 'axios';

const url = 'https://api-random-user.dataandapis.com/v1/user';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

One subscription. Every API.

Tokens unlock this API and 125+ others on DataAndAPIs. Switch APIs any time — we promote.

FREE

$0/mo

500 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Community support
Start free
Most Popular

STARTER

$6.99/mo

25,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Email support
Subscribe

PRO

$24.99/mo

100,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority email support
Subscribe

ULTRA

$99.99/mo

1,000,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority support
Subscribe

Need higher volume, dedicated infra, or a custom contract? Talk to sales →

Questions about Random User API

Ship Random User API this afternoon.

500 free tokens. No card. Plus 125+ other APIs on the same key.