Random User

Generate random fake user profiles for testing and prototyping. Each call returns a unique name, email address, phone number, mailing address, and avatar URL.

Get API Key

Overview

Use Cases

Populate test databases with realistic-looking user records
Demo and prototype applications without real user data
Load testing with varied user payloads
UI mockups and design previews

Features

Realistic names, emails, and phone numbers via jaswdr/faker

Full mailing address including street, city, state, zip, and country

Unique avatar URL per generated user (DiceBear Identicon)

Every call returns a different random user

API Endpoints

Get Random User

Returns a randomly generated fake user profile.

GET

https://api.requiems.xyz/v1/misc/random-user

Try it out

Live Demo

Request

Response Fields

Field	Type	Description
name	`string`	Full name of the generated user
email	`string`	Email address of the generated user
phone	`string`	Phone number of the generated user
address.street	`string`	Street address
address.city	`string`	City name
address.state	`string`	State or region
address.zip	`string`	Postal / ZIP code
address.country	`string`	Country name
avatar	`string`	URL to a unique identicon avatar for the generated user (DiceBear)

Code Examples

curl https://api.requiems.xyz/v1/misc/random-user \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://api.requiems.xyz/v1/misc/random-user"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
user = response.json()['data']
print(f"Generated user: {user['name']} <{user['email']}>")

const response = await fetch(
  'https://api.requiems.xyz/v1/misc/random-user',
  {
    headers: {
      'requiems-api-key': 'YOUR_API_KEY'
    }
  }
);

const { data } = await response.json();
console.log(`Generated user: ${data.name} <${data.email}>`);

require 'net/http'
require 'json'

uri = URI('https://api.requiems.xyz/v1/misc/random-user')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

user = JSON.parse(response.body)['data']
puts "Generated user: #{user['name']} <#{user['email']}>"

Error Responses

500

internal_error

Internal server error

No results found