Fake people and companies
Generate realistic test people, addresses, companies and French or European identifiers (SIREN, SIRET, IBAN, EU VAT) with valid keys, in French or English. Typical uses: fill a demo database, test forms and screens without real personal data.
fake first_namefake first_namefake last_namefake last_namefake namefake namefake personfake personfake emailfake emailfake phonefake phonefake addressfake addressfake companyfake companyfake sirenfake sirenfake siretfake siretfake ibanfake ibanfake vat_eufake vat_eu

fake first_name


Description

    A first name of the locale. Each call gives another value

admin
fake first_name
mentdb
Charlotte

fake first_name <params>


Description

    A first name of the locale, with parameters: gender (any, female or male), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake first_name "{\"seed\": 1}"
mentdb
Émilie
a female first name in English
admin
fake first_name "{\"seed\": 1, \"gender\": \"female\", \"locale\": \"en\"}"
mentdb
Margaret

fake last_name


Description

    A last name of the locale. Each call gives another value

admin
fake last_name
mentdb
Meyer

fake last_name <params>


Description

    A last name of the locale, with parameters: seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake last_name "{\"seed\": 3, \"locale\": \"en_gb\"}"
mentdb
Walker

fake name


Description

    A first name and a last name. Each call gives another value

admin
fake name
mentdb
Lucie Dumont

fake name <params>


Description

    A first name and a last name, with parameters: gender (any, female or male), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake name "{\"seed\": 1}"
mentdb
Émilie Nicolas
a man
admin
fake name "{\"seed\": 1, \"gender\": \"male\"}"
mentdb
Gabriel Lemaire

fake person


Description

    A person as a JSON object whose fields agree: gender, first_name, last_name, name, email (made from the name), phone, birth_date (1940 to 2006), street, postcode, city (the postcode is a real one of the city), region, country. Each call gives another value

admin
fake person
mentdb
{"gender": "female", "first_name": "Aurélie", "last_name": "Petit", "name": "Aurélie Petit", "email": "aurelie_petit@example.net", "phone": "02 61 91 36 73", "birth_date": "1962-05-02", "street": "88 rue des Cocotiers", "postcode": "59260", "city": "Lille", "region": "Hauts-de-France", "country": "France"}

fake person <params>


Description

    A person as a JSON object whose fields agree: gender, first_name, last_name, name, email (made from the name), phone, birth_date (1940 to 2006), street, postcode, city (the postcode is a real one of the city), region, country, with parameters: gender, domain (as fake email), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake person "{\"seed\": 7}"
mentdb
{"gender": "male", "first_name": "Paul", "last_name": "André", "name": "Paul André", "email": "paul.andre54@example.com", "phone": "02 61 91 69 76", "birth_date": "1969-08-30", "street": "126 rue Émile Zola", "postcode": "14000", "city": "Caen", "region": "Normandie", "country": "France"}
a person in the United States: the area code of the phone is the one of the city
admin
fake person "{\"seed\": 7, \"locale\": \"en\"}"
mentdb
{"gender": "male", "first_name": "Liam", "last_name": "Johnson", "name": "Liam Johnson", "email": "liam.johnson54@example.com", "phone": "(214) 555-0131", "birth_date": "1969-08-30", "street": "9584 Union Street", "postcode": "75202", "city": "Dallas", "region": "TX", "country": "United States"}

fake email


Description

    An email address on example.com, example.org or example.net only: these domains are reserved by RFC 2606 and no mail can reach a real person. The address is made from a generated name. Each call gives another value

admin
fake email
mentdb
frederic_garcia@example.com

fake email <params>


Description

    An email address on example.com, example.org or example.net only: these domains are reserved by RFC 2606 and no mail can reach a real person. The address is made from a generated name, with parameters: domain (example.com, example.org, example.net or one of their subdomains, ex: shop.example.com; any other domain is refused), first_name and last_name (build the address from a given name: accents are removed), gender, seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake email "{\"first_name\": \"Hélène\", \"last_name\": \"Payet-Técher\", \"seed\": 3}"
mentdb
helene.payet-techer@example.org
on a subdomain
admin
fake email "{\"seed\": 3, \"domain\": \"crm.example.com\"}"
mentdb
jade.dumont@crm.example.com
a real domain is refused
admin
fake email "{\"domain\": \"gmail.com\"}"
mentdb
ERROR: Sorry, an error appears (the parameter 'domain' must be example.com, example.org, example.net or one of their subdomains (RFC 2606): no generated address may reach a real person).

fake phone


Description

    A phone number taken only from the blocks reserved for fiction. France: 01 99 00, 02 61 91, 03 53 01, 04 65 71, 05 36 49 and 06 39 98 (ARCEP, plan national de numerotation, numbers for audiovisual works: they can neither call nor be called). United States: 555-0100 to 555-0199 (NANP numbers for fiction). United Kingdom: the Ofcom ranges for drama, such as 020 7946 0xxx and 07700 900xxx. Each call gives another value

admin
fake phone
mentdb
06 39 98 22 59

fake phone <params>


Description

    A phone number taken only from the blocks reserved for fiction. France: 01 99 00, 02 61 91, 03 53 01, 04 65 71, 05 36 49 and 06 39 98 (ARCEP, plan national de numerotation, numbers for audiovisual works: they can neither call nor be called). United States: 555-0100 to 555-0199 (NANP numbers for fiction). United Kingdom: the Ofcom ranges for drama, such as 020 7946 0xxx and 07700 900xxx, with parameters: kind (any, landline or mobile; the US numbers have no kind), format (national, international or e164), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake phone "{\"seed\": 2, \"kind\": \"mobile\", \"format\": \"international\"}"
mentdb
+33 6 39 98 67 46
a US number in E.164
admin
fake phone "{\"seed\": 2, \"locale\": \"en\", \"format\": \"e164\"}"
mentdb
+14045550176
a British landline
admin
fake phone "{\"seed\": 2, \"locale\": \"en_gb\", \"kind\": \"landline\"}"
mentdb
0113 496 0767

fake address


Description

    An address as a JSON object: street, postcode, city, region, country, country_code, line (the address on one line). The city and its postcode go together (a small list of real cities and postcodes); the street is made up and may or may not exist in that city. Each call gives another value

admin
fake address
mentdb
{"street": "125 boulevard du Moulin", "postcode": "17000", "city": "La Rochelle", "region": "Nouvelle-Aquitaine", "country": "France", "country_code": "FR", "line": "125 boulevard du Moulin, 17000 La Rochelle"}

fake address <params>


Description

    An address as a JSON object: street, postcode, city, region, country, country_code, line (the address on one line). The city and its postcode go together (a small list of real cities and postcodes); the street is made up and may or may not exist in that city, with parameters: seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake address "{\"seed\": 5}"
mentdb
{"street": "105 boulevard du Moulin", "postcode": "59260", "city": "Lille", "region": "Hauts-de-France", "country": "France", "country_code": "FR", "line": "105 boulevard du Moulin, 59260 Lille"}
in the United States: region is the state
admin
fake address "{\"seed\": 5, \"locale\": \"en\"}"
mentdb
{"street": "3497 Elm Drive", "postcode": "97205", "city": "Portland", "region": "OR", "country": "United States", "country_code": "US", "line": "3497 Elm Drive, Portland, OR 97205"}
in the United Kingdom
admin
fake address "{\"seed\": 5, \"locale\": \"en_gb\"}"
mentdb
{"street": "73 Grange Terrace", "postcode": "NG7 4GF", "city": "Nottingham", "region": "England", "country": "United Kingdom", "country_code": "GB", "line": "73 Grange Terrace, Nottingham NG7 4GF"}

fake company


Description

    A company name with its legal form (SARL, SAS... in France, Inc. or LLC in the United States, Ltd in the United Kingdom). Each call gives another value

admin
fake company
mentdb
Leroux Industrie SAS

fake company <params>


Description

    A company name with its legal form (SARL, SAS... in France, Inc. or LLC in the United States, Ltd in the United Kingdom), with parameters: seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake company "{\"seed\": 7}"
mentdb
Brun Industrie SA
a British one
admin
fake company "{\"seed\": 7, \"locale\": \"en_gb\"}"
mentdb
Bennett Industries Ltd

fake siren


Description

    A French SIREN: 9 digits with a valid Luhn key. It is not checked against the official register and may be the number of a real company. Each call gives another value

admin
fake siren
mentdb
561835455

fake siren <params>


Description

    A French SIREN: 9 digits with a valid Luhn key. It is not checked against the official register and may be the number of a real company, with parameters: seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake siren "{\"seed\": 7}"
mentdb
784523714

fake siret


Description

    A French SIRET: a SIREN, an establishment number and a valid Luhn key. It may be the number of a real establishment. Each call gives another value

admin
fake siret
mentdb
24092380536572

fake siret <params>


Description

    A French SIRET: a SIREN, an establishment number and a valid Luhn key. It may be the number of a real establishment, with parameters: siren (a given SIREN: a new establishment of this company), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake siret "{\"seed\": 7}"
mentdb
78452371415894
an establishment of a given company
admin
fake siret "{\"seed\": 1, \"siren\": \"732829320\"}"
mentdb
73282932096114

fake iban


Description

    An IBAN with valid check digits, and a valid national key where the country has one (French RIB key, Belgian and Spanish keys). It is not a real account, but it may be the number of a real one: never send money to it. Each call gives another value

admin
fake iban
mentdb
FR7621130499385246083837537

fake iban <params>


Description

    An IBAN with valid check digits, and a valid national key where the country has one (French RIB key, Belgian and Spanish keys). It is not a real account, but it may be the number of a real one: never send money to it, with parameters: country (FR, DE, BE, ES, NL or GB; FR by default), format (compact, or print: groups of 4), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake iban "{\"seed\": 7, \"format\": \"print\"}"
mentdb
FR76 1388 3138 0744 6895 2747 559
German
admin
fake iban "{\"seed\": 7, \"country\": \"DE\"}"
mentdb
DE35138831380744689527

fake vat_eu


Description

    An EU VAT number with a valid key. In France it is computed from a SIREN, as the tax office does. It may be the number of a real company. Each call gives another value

admin
fake vat_eu
mentdb
FR79313939811

fake vat_eu <params>


Description

    An EU VAT number with a valid key. In France it is computed from a SIREN, as the tax office does. It may be the number of a real company, with parameters: country (FR, DE, BE or IT; FR by default), siren (FR only: the number of this SIREN), seed (an integer or a text: the same seed gives the same result on every run and every machine), locale (fr by default, en for the United States, en_gb for the United Kingdom)

Parameters

    params:   The parameters as JSON - String - required
admin
fake vat_eu "{\"seed\": 7}"
mentdb
FR14784523714
from a given SIREN
admin
fake vat_eu "{\"siren\": \"732829320\"}"
mentdb
FR44732829320
Italian
admin
fake vat_eu "{\"seed\": 7, \"country\": \"IT\"}"
mentdb
IT08936950107