Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Random User Generator Users API

Generate one or more synthetic user records.

Random User Generator Users API is published by Random User Generator on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Users. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a JSON-LD context, rate-limit docs, authentication docs, and 3 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 1.4.

Requests are made against 2 base URLs: https://randomuser.me/api, https://randomuser.me/api/1.4.

2 operations 2 paths 10 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.4
Base URL
https://randomuser.me/api
Contact
License
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Users 2

Generate one or more synthetic user records.

GET
/
Generate Random Users
generateUsers 12 params → 200500
GET
/{version}/
Generate Random Users (Pinned Version)
generateUsersVersioned 13 params → 200

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are User (12 properties), Location (7 properties), Login (7 properties), Info (4 properties). Each schema is shown below with its type and property counts.

User
object
A single synthetic user record.
12 properties
Name
object
3 properties
Picture
object
3 properties
UserResponse
object
Standard envelope returned by the generator.
2 properties 2 required
Location
object
7 properties
Login
object
7 properties
Error
object
1 property 1 required
DateWithAge
object
2 properties
Id
object
2 properties
Info
object
Metadata about the generated batch.
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

randomuser-users-api-openapi.yml Raw ↑