Skip to content

Random User Generator API

Fake people for lists, profile screens and test data, with real-looking Khmer names.

Fill a contact list, a chat screen or a test database with people who look real. Each user has a name in Latin letters and in Khmer script (family name first, as in Cambodia), a gender, a username and example.com email, a +855 phone number in international, local and E.164 formats, an address in one of the 25 provinces, a job and an avatar image.

Ask for up to 50 users at once. Pass the same seed and page to get exactly the same people again, which keeps screenshots and tests stable. Everyone is fictional.

Base URL https://toolorca.com/api/v1 No key · CORS open · JSON · conventions and limits

Endpoints

GET /api/v1/random/user #

One or more random users.

Parameter In Type Description
results query integer 1 to 50 (default 1).
nat query string KH (default), US, GB, JP, KR, VN, TH, FR, a comma-separated mix, or all.
gender query string male or female.
seed query string Any text. The same seed returns the same users (a random seed is used and returned otherwise).
page query integer Next set of users for the same seed (1–1000).
curl 'https://toolorca.com/api/v1/random/user?results=2&seed=toolorca'
GET /random/user?results=2&seed=toolorca
Example response
{
  "data": [
    {
      "id": "0bd90803-3387-48cd-89b8-9bece8df78d0",
      "gender": "female",
      "nat": "KH",
      "name": {
        "first": "Phalla",
        "last": "Meas",
        "full": "Meas Phalla",
        "firstKm": "ផល្លា",
        "lastKm": "មាស",
        "fullKm": "មាស ផល្លា",
        "order": "family-first"
      },
      "phone": {
        "international": "+855 11 215 1149",
        "local": "011 215 1149",
        "e164": "+855112151149"
      },
      "address": {
        "houseNo": "No. 301",
        "street": "National Road 5",
        "province": "Oddar Meanchey",
        "provinceKm": "ឧត្ដរមានជ័យ",
        "provinceCode": "KH-22",
        "postalCode": "220118",
        "country": "Cambodia",
        "countryCode": "KH",
        "coordinates": {
          "lat": 14.1269,
          "lon": 103.5664
        }
      },
      "job": {
        "title": "Teacher",
        "titleKm": "គ្រូបង្រៀន",
        "company": "Tonle Logistics"
      },
      "username": "phalla.meas97",
      "email": "phalla.meas97@example.com",
      "birthDate": "2001-10-01",
      "age": 24,
      "avatar": "https://toolorca.com/api/v1/images/placeholder/200x200.png?text=PM&bg=4338ca&fg=ffffff",
      "registeredAt": "2024-01-18"
    },
    {
      "id": "42b161df-8d54-4a9a-8363-317377788a48",
      "gender": "female",
      "nat": "KH",
      "name": {
        "first": "Chantrea",
        "last": "Vong",
        "full": "Vong Chantrea",
        "firstKm": "ចន្ទ្រា",
        "lastKm": "វង្ស",
        "fullKm": "វង្ស ចន្ទ្រា",
        "order": "family-first"
      },
      "phone": {
        "international": "+855 95 725 528",
        "local": "095 725 528",
        "e164": "+85595725528"
      },
      "address": {
        "houseNo": "No. 29",
        "street": "Street 310",
        "province": "Phnom Penh",
        "provinceKm": "ភ្នំពេញ",
        "provinceCode": "KH-12",
        "postalCode": "127660",
        "country": "Cambodia",
        "countryCode": "KH",
        "coordinates": {
          "lat": 11.5418,
          "lon": 104.8823
        }
      },
      "job": {
        "title": "Banker",
        "titleKm": "បុគ្គលិកធនាគារ",
        "company": "Angkor Cloud Solutions"
      },
      "username": "chantrea.vong7",
      "email": "chantrea.vong7@example.com",
      "birthDate": "1991-11-13",
      "age": 34,
      "avatar": "https://toolorca.com/api/v1/images/placeholder/200x200.png?text=CV&bg=7c3aed&fg=ffffff",
      "registeredAt": "2024-07-15"
    }
  ],
  "info": {
    "seed": "toolorca",
    "results": 2,
    "page": 1,
    "nat": "KH",
    "note": "Fictional people. Phone numbers and emails (example.com) are made up. Same seed and page = same people."
  }
}

GET /api/v1/random/name #

Just names (Latin and Khmer), for quick test data.

Parameter In Type Description
results query integer 1 to 50.
nat / gender / seed / page query string As for /random/user.
curl 'https://toolorca.com/api/v1/random/name?results=5&seed=demo'
GET /random/name?results=5&seed=demo
Example response
{
  "data": [
    {
      "gender": "female",
      "nat": "KH",
      "first": "Davy",
      "last": "Keo",
      "full": "Keo Davy",
      "firstKm": "ដាវី",
      "lastKm": "កែវ",
      "fullKm": "កែវ ដាវី",
      "order": "family-first"
    },
    {
      "gender": "male",
      "nat": "KH",
      "first": "Sokhom",
      "last": "Yim",
      "full": "Yim Sokhom",
      "firstKm": "សុខុម",
      "lastKm": "យឹម",
      "fullKm": "យឹម សុខុម",
      "order": "family-first"
    },
    {
      "gender": "male",
      "nat": "KH",
      "first": "Rotha",
      "last": "Chea",
      "full": "Chea Rotha",
      "firstKm": "រដ្ឋា",
      "lastKm": "ជា",
      "fullKm": "ជា រដ្ឋា",
      "order": "family-first"
    },
    "… 2 more"
  ],
  "info": {
    "seed": "demo",
    "results": 5,
    "page": 1,
    "nat": "KH"
  }
}

Khmer name order

Cambodians write the family name first: full is “Chan Sokha” and fullKm is “ចាន់ សុខា”. name.order tells you which order a name uses (family-first for Cambodian, Japanese, Korean and Vietnamese users), so you can sort and display names correctly.

Free daily limit

Shared with the other mock services: 50 requests per day and 10 per minute per IP address. One request can return 50 users, so generate your test data once with a seed and save it.

Frequently asked questions

Are these real people?

No. Names are common names combined at random; phone numbers, emails (example.com) and addresses are made up.

How do I get the same users every time?

Add seed=anything. The same seed, page, nat and gender always return the same users.

What do the avatars look like?

A coloured square with the person’s initials, served by the placeholder image endpoint, so they work in any image widget.

Which phone formats are returned?

International (+855 12 345 678), local (012 345 678) and E.164 (+85512345678) for Cambodian users.

More free APIs