Random User API

API for random fake user info: gender, name, email, address

Random User API Documentation

The Random User API provides randomly generated user data for testing and development. It includes details like name, address, contact information, login credentials, profile picture, and user ID. This API is useful for creating mock user profiles, helping developers simulate real-world data scenarios during app or software development.

Base URL

https://santechapi.vercel.app

Authentication

headers : {
"token" : {YOUR API KEY}
}

Endpoint : /randomuser/

HTTP Method: Get

Example request

GET /randomuser/

Example Response

200

{
	"results": [
		{
			"gender": "female",
			"name": {
				"title": "Mrs",
				"first": "Malathy",
				"last": "Acharya"
			},
			"location": {
				"street": {
					"number": 2590,
					"name": "Chaman Ganj"
				},
				"city": "Satara",
				"state": "Goa",
				"country": "India",
				"postcode": 16331,
				"coordinates": {
					"latitude": "8.4497",
					"longitude": "159.4510"
				},
				"timezone": {
					"offset": "+2:00",
					"description": "Kaliningrad, South Africa"
				}
			},
			"email": "[e-mail]",
			"login": {
				"uuid": "508842d4-1f70-40df-82fa-fc12a3c1b0f4",
				"username": "purplezebra824",
				"password": "woodie",
				"salt": "8Bdb19qi",
				"md5": "505e16b7d53a1e00a2dd7505bdc0dd2a",
				"sha1": "57eecea9639e935da4490d65d7002e3a329fe254",
				"sha256": "4a8b8f783146f1b16dae6aced9c99a2ce3edff8bcc92c3105ab3bf8d77b25aaa"
			},
			"dob": {
				"date": "1948-08-16T23:35:41.898Z",
				"age": 76
			},
			"registered": {
				"date": "2005-02-07T06:36:48.434Z",
				"age": 19
			},
			"phone": "7707093091",
			"cell": "9526702382",
			"id": {
				"name": "UIDAI",
				"value": "869562310963"
			},
			"picture": {
				"large": "https://randomuser.me/api/portraits/women/63.jpg",
				"medium": "https://randomuser.me/api/portraits/med/women/63.jpg",
				"thumbnail": "https://randomuser.me/api/portraits/thumb/women/63.jpg"
			},
			"nat": "IN"
		}
	],
	"info": {
		"seed": "a199d4e030af5bbd",
		"results": 1,
		"page": 1,
		"version": "1.4"
	}
}

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

400

 {
message: "Unable to fetch Random user details"
}