Generator · US data
US person
Endpoint GET /v1/us/person
What it covers
Returns a consistent synthetic US person: name, surname, initials, birth date, sex, and a matching SSN. The `sex` and age filters work as they do for every other country — but note why they can. A Danish CPR or Polish PESEL *encodes* the birth date and sex, so those endpoints read the filters back out of the identifier. A US SSN encodes **neither**, so here the filters shape the drawn birth date and name directly, and nothing about the resulting SSN reflects them. `invalid=true` makes only the SSN fail validation; the name and birth date stay clean.
Parameters
| Parameter | Type | Description |
|---|---|---|
| atAge | integer | Exact age in years at request time. |
| bornAfter | stringpattern ^\d{4}(?:-\d{2}(?:-\d{2})?)?$ | Born after this date or fragment (YYYY, YYYY-MM, YYYY-MM-DD). |
| bornBefore | stringpattern ^\d{4}(?:-\d{2}(?:-\d{2})?)?$ | Born before this date or fragment (YYYY, YYYY-MM, YYYY-MM-DD). |
| bornOn | stringpattern ^\d{4}(?:-\d{2}(?:-\d{2})?)?$ | Born on a date or within a fragment: YYYY, YYYY-MM, or YYYY-MM-DD. |
| caseStrict | boolean | Keep proper name casing (default `true`). Set `false` to deliberately mangle it — all-lowercase, all-UPPERCASE, or random — to stress-test case-insensitive consumers. Initials stay uppercase regardless. |
| count | integer1–10000 | Number of records to return, 1–10000. Omitted returns a single record; set it for a batch. Costs 1 token plus a tenth per record. |
| edge | boolean | Restrict output to valid edge cases from the rare corners of the domain. |
| extreme | boolean | Return a correct value wrapped in a hostile encoding (untrimmed whitespace, invisible/zero-width characters, BOM, or bidi/combining marks). Homoglyphs are excluded so the value stays machine-parseable; it still validates after normalisation. |
| format | "plain" | "with-hyphens" | SSN rendering: `with-hyphens` (default, `123-45-6789`) or `plain` (9 bare digits). |
| invalid | boolean | Return a deliberately invalid value that fails validation, for testing rejection paths. |
| olderThan | integer | Minimum age in years at request time. |
| seed | integer | Integer seed for reproducible output: the same seed always yields the same record. |
| sex | "m" | "f" | Encoded sex: "m" or "f". |
| youngerThan | integer | Maximum age in years at request time. |
Response fields
| Field | Type | Description |
|---|---|---|
| name | string | Given name(s), including a middle name where drawn. |
| surname | string | Surname, e.g. `Rodriguez`. |
| initials | string | Uppercase initials of name and surname, no dots. |
| birthDate | string | The birth date, ISO `YYYY-MM-DD`. Drawn independently — the SSN encodes no date. |
| sex | "m" | "f" | The person’s sex. Drawn independently — the SSN encodes no sex. |
| ssn | string | The matching SSN, rendered per the requested format. |
Other generators for United States
American company nameAmerican email addressAmerican person nameAmerican product or service offeringUS ABA routing transit numberUS bank accountUS companyUS Employer Identification NumberUS Social Security NumberUS vehicle registration plate
See all generators for United States →The same kind of identifier elsewhere
Austrian data · Austrian personBelgian data · Belgian personBulgarian data · Bulgarian personCanadian data · Canadian personCroatian data · Croatian personCypriot data · Cypriot personCzech data · Czech personDanish data · Danish personDutch data · Dutch personEstonian data · Estonian personFinnish data · Finnish personFrench data · French personGerman data · German personGreek data · Greek personHungarian data · Hungarian personIrish data · Irish personItalian data · Italian personLatvian data · Latvian personLithuanian data · Lithuanian personLuxembourg data · Luxembourg personMaltese data · Maltese personPolish data · Polish personPortuguese data · Portuguese personRomanian data · Romanian personSlovak data · Slovak personSlovenian data · Slovenian personSpanish data · Spanish personSwedish data · Swedish person
Try it