Generator · Generic data
Person name
Endpoint GET /v1/person-name
What it covers
Returns a realistic synthetic person name drawn from a mix of EU countries. Pass `countries` as a comma-separated list of ISO codes (`?countries=pl,sk,it`) and each record is generated by one of them, picked at random — so a batch can mix Polish, Slovak, and Italian names, each in its own local form. Omit `countries` to draw from all 27 EU countries. Each record reports the `country` it came from. `sex`, `edge`, and `caseStrict` work as on the per-country endpoints.
Parameters
| Parameter | Type | Description |
|---|---|---|
| caseStrict | boolean | Defaults to true (proper casing). Set false to deliberately mangle the casing of name and surname (all-lower, all-upper, or random); initials stay proper uppercase. |
| count | integer1–1000 | Number of records to return, 1–1000 (your plan may lower this). Omitted returns a single record; set it for a batch. |
| countries | "at" | "be" | "bg" | "cy" | "cz" | "de" | "dk" | "ee" | "es" | "fi" | "fr" | "gr" | "hr" | "hu" | "ie" | "it" | "lt" | "lu" | "lv" | "mt" | "nl" | "pl" | "pt" | "ro" | "se" | "si" | "sk"[] | Comma-separated ISO 3166 country codes to draw from, e.g. `pl,sk,it`. Omit for all 27. |
| edge | boolean | Bias toward edge-case name shapes (second given names, double surnames, short names). |
| extreme | boolean | Return a correct name whose name and surname are wrapped in a hostile encoding (untrimmed whitespace, invisible/zero-width characters, BOM, homoglyph letters, or bidi/combining marks). initials stay clean. |
| invalid | boolean | Return a deliberately invalid value that fails validation, for testing rejection paths. |
| seed | integer | Integer seed for reproducible output: the same seed always yields the same record. |
| sex | "m" | "f" | Gendered form of the name: "m" or "f". Omit for random. |
Response fields
| Field | Type | Description |
|---|---|---|
| name | string | Given (first) name(s), in the local script, agreeing with the sex. |
| surname | string | Surname in the form matching the sex (inflected where required). |
| initials | string | Uppercase initials of name and surname, no dots. |
| sex | "m" | "f" | The sex the name was inflected for. |
| country | string | ISO 3166 alpha-2 code of the country this name was drawn from. |
Other generic generators
Auto-increment integer sequenceCompany name from one or more EU countriesDraw a member from a weighted enumerationDraw an object from a weighted list of candidatesEmail address from one or more EU countriesLorem ipsum textMongoDB ObjectIdNano IDProduct or service offeringString matching a regular expressionULIDUUID
Try it