Generator · US data

US Social Security Number

Endpoint GET /v1/us/ssn

What it covers

Returns a synthetic US Social Security Number in an issuable range: area `001`–`899` excluding `666`, group `01`–`99`, serial `0001`–`9999`. The SSN carries **no checksum** and encodes nothing — not sex, not birth date, and since the SSA moved to randomised assignment in 2011, not even a state of issue — so there are no age or `sex` filters here. `invalid=true` returns a number that violates the issuable-range mask (a reserved area/group/serial, an illegal character, or the wrong length).

Parameters

ParameterTypeDescription
countinteger1–10000Number of records to return, 1–10000. Omitted returns a single record; set it for a batch. Costs 1 token plus a tenth per record.
edgebooleanRestrict output to valid edge cases from the rare corners of the domain.
extremebooleanReturn 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"Rendering: `with-hyphens` (default, `123-45-6789`) or `plain` (9 bare digits).
invalidbooleanReturn a deliberately invalid value that fails validation, for testing rejection paths.
seedintegerInteger seed for reproducible output: the same seed always yields the same record.

Response fields

FieldTypeDescription
valuestringThe SSN rendered per `format` (hyphenated by default).
digitsstringThe canonical nine digits, unformatted.
areaNumberstringThe three-digit area number, e.g. `451`.
groupNumberstringThe two-digit group number, e.g. `27`.
serialNumberstringThe four-digit serial number, e.g. `8834`.

Other generators for United States

See all generators for United States →

The same kind of identifier elsewhere

Try it

Generate a live example below — every response is valid by format and entirely synthetic.