Overview

This endpoint generates a comprehensive fake person profile, including details such as name, gender, username, email, password, date of birth, phone number, and address. It supports localization by accepting an optional two-letter country code parameter, tailoring the generated data to the specified locale. If the country code is not supported or not provided, the service defaults to US (United States) locale.
HTTP Request

bash

GET /[country_code]

URL Parameters

country_code (optional): A two-letter ISO 3166-1 alpha-2 country code that specifies the locale for the generated data. If omitted, the API defaults to generating data based on the US locale. If a non-supported country code is provided, the API also defaults to the US locale.

Query Parameters

gender (optional): Specifies the gender for the generated profile. Acceptable values are male or female. If omitted, the gender is randomly selected.

Response Format

The response is a JSON object containing the generated fake person’s profile, structured as follows:

json

{
“gender”: “female”,
“first_name”: “Jane”,
“last_name”: “Doe”,
“username”: “jane.doe47”,
“email”: "jane.doe47@example.com",
“password”: “p@ssW0rd!”,
“dob”: “1985-05-15”,
“phone_number”: “(555) 555-0123”,
“address”: {
“full_address”: “123 Main St, Springfield, IL, 62701”,
“street_name”: “Main St”,
“street_number”: “123”,
“city”: “Springfield”,
“region”: “IL”,
“zip_code”: “62701”
}
}

Example Request

bash

GET /de

This request generates a fake person profile localized for Germany (DE), with randomized gender.
Notes

The country_code parameter should be a valid two-letter ISO 3166-1 alpha-2 code. The API is designed to recognize several country codes, dynamically adjusting the generated data to match the cultural and linguistic characteristics of the specified country. Unsupported country codes, or requests where the country_code parameter is omitted, will result in data that defaults to the US locale.
The optional gender query parameter allows for further customization of the generated profile, ensuring versatility for various testing and development scenarios.

Usage Tips

Utilize the optional gender parameter to test specific gender-based workflows or UI layouts.
The dynamic localization feature can be particularly useful for testing applications designed for international use, ensuring form fields, data validation, and user interfaces are appropriately customized for different regions.