Person generator

A fake person is generated when the page opens. Choose the nationality, the sex and, for Brazil, the state, or click "Generate person" to create another one.

Sex

How it works

  • The person is generated on the server and is not stored anywhere.
  • Brazilians come with a valid CPF and RG (the RG follows the São Paulo rule) and a real address: the CEP exists and matches the street, neighborhood and city. The phone numbers use the city's area code, and the name takes a surname from the mother followed by one from the father.
  • For the other nationalities, the name, address, phone number and date follow the country's format, with data from Faker. The address is made up and there are no documents; fields Faker has no data for in that country are left out.
  • The email uses domains reserved for testing (example.com), so no message ever reaches a real person.
  • The data is for testing only and does not belong to any real person.

How to use the API

You can integrate the person generator into your app through our REST API.

Endpoint

GET /api/generators/person

Query parameters

nationality
Optional. The country code, such as "BR" or "DE". Default: "BR". For other nationalities, the response has "phone", "address", "zipCode" and "country" instead of the Brazilian fields.
sex
Optional. "female" or "male". Without it, the sex is picked at random. Brazilians come with "Feminino" or "Masculino" in the response.
state
Optional, only with nationality=BR. The state abbreviation, such as "SP". Without it, the state is picked at random.

curl example

curl "https://devtools.vmotta.dev/api/generators/person?nationality=DE&sex=female"

Response

{
  "person": {
    "nationality": "DE",
    "name": "Michaela Löser",
    "sex": "female",
    "birthdate": "14.05.1984",
    "age": 42,
    "motherName": "Malin Löser",
    "fatherName": "Jordan Löser",
    "email": "michaela.loser83@example.com",
    "password": "zmwbsy-abdmnZ-3femhv",
    "phone": "(00792) 9666250",
    "address": "Franz-Hitze-Str. 429",
    "city": "Neu Alishascheid",
    "state": "Bremen",
    "zipCode": "58954",
    "country": "Deutschland",
    "height": "1,64 m",
    "weight": "68 kg",
    "bloodType": "A+"
  }
}