Random User Generator · Schema
User
A single synthetic user record returned by the Random User Generator API.
Test DataSynthetic DataMock DataOpen-SourcePublic APIFree API
Properties
| Name | Type | Description |
|---|---|---|
| gender | string | |
| name | object | |
| location | object | |
| string | ||
| login | object | |
| dob | object | |
| registered | object | |
| phone | string | |
| cell | string | |
| id | object | |
| picture | object | |
| nat | string | ISO 3166-1 alpha-2 country code. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://randomuser.me/schemas/user.json",
"title": "User",
"description": "A single synthetic user record returned by the Random User Generator API.",
"type": "object",
"x-schema-source": "documentation",
"x-source-url": "https://randomuser.me/documentation",
"properties": {
"gender": { "type": "string", "enum": ["male", "female"] },
"name": {
"type": "object",
"properties": {
"title": { "type": "string" },
"first": { "type": "string" },
"last": { "type": "string" }
},
"required": ["title", "first", "last"]
},
"location": {
"type": "object",
"properties": {
"street": {
"type": "object",
"properties": {
"number": { "type": "integer" },
"name": { "type": "string" }
}
},
"city": { "type": "string" },
"state": { "type": "string" },
"country": { "type": "string" },
"postcode": { "type": ["string", "integer"] },
"coordinates": {
"type": "object",
"properties": {
"latitude": { "type": "string" },
"longitude": { "type": "string" }
}
},
"timezone": {
"type": "object",
"properties": {
"offset": { "type": "string" },
"description": { "type": "string" }
}
}
}
},
"email": { "type": "string", "format": "email" },
"login": {
"type": "object",
"properties": {
"uuid": { "type": "string", "format": "uuid" },
"username": { "type": "string" },
"password": { "type": "string" },
"salt": { "type": "string" },
"md5": { "type": "string" },
"sha1": { "type": "string" },
"sha256": { "type": "string" }
}
},
"dob": {
"type": "object",
"properties": {
"date": { "type": "string", "format": "date-time" },
"age": { "type": "integer", "minimum": 0 }
}
},
"registered": {
"type": "object",
"properties": {
"date": { "type": "string", "format": "date-time" },
"age": { "type": "integer", "minimum": 0 }
}
},
"phone": { "type": "string" },
"cell": { "type": "string" },
"id": {
"type": "object",
"properties": {
"name": { "type": "string", "description": "Identifier scheme (e.g. SSN, NINO). May be empty for some nationalities." },
"value": { "type": ["string", "null"] }
}
},
"picture": {
"type": "object",
"properties": {
"large": { "type": "string", "format": "uri" },
"medium": { "type": "string", "format": "uri" },
"thumbnail": { "type": "string", "format": "uri" }
}
},
"nat": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code.",
"pattern": "^[A-Z]{2}$"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/randomuser-user"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.