GET /randomuser
Generate a realistic random user profile from the RandomUser.me API, a popular service for generating fake user data. Returns a complete user identity including name, email, phone, address (street, city, state, country, postcode), date of birth, age, profile picture URLs (thumbnail, medium, large), login credentials (username, password), nationality, and a unique ID. Unlike the /generate/user endpoint which generates simple profiles locally, this endpoint produces richer, more realistic data with actual profile photos. Ideal for UI prototyping, populating demo environments, testing user registration flows, and creating realistic mockup data for presentations.
gender
optional
Filter by gender (male or female)
nat
optional
Nationality code (e.g., US, GB, NO, FI, DK)
| Name | Required | Default | Description |
|---|---|---|---|
gender |
No | - | Filter by gender (male or female) |
nat |
No | - | Nationality code (e.g., US, GB, NO, FI, DK) |
curl https://nordapi.ee/api/v1/randomuser
curl https://nordapi.ee/api/v1/randomuser
curl "https://nordapi.ee/api/v1/randomuser?nat=NO"
curl "https://nordapi.ee/api/v1/randomuser?gender=female&nat=FI"
curl "https://nordapi.ee/api/v1/randomuser?nat=DK"
{
"count": 1,
"data": [
{
"age": 54,
"date_of_birth": "1971-05-02T11:30:58.977Z",
"email": "tatiana.stefanovic@example.com",
"gender": "female",
"location": {
"city": "Požarevac",
"country": "Serbia",
"latitude": "58.9486",
"longitude": "113.6652",
"postcode": 14830,
"state": "Kolubara"
},
"name": {
"first": "Tatiana",
"last": "Stefanović",
"title": "Mrs"
},
"nationality": "RS",
"phone": "012-2828-039",
"picture": {
"large": "https://randomuser.me/api/portraits/women/17.jpg",
"medium": "https://randomuser.me/api/portraits/med/women/17.jpg",
"thumbnail": "https://randomuser.me/api/portraits/thumb/women/17.jpg"
},
"registered": "2014-02-27T02:54:06.517Z",
"username": "yellowduck214"
}
],
"success": true
}