---
id: "usssn"
kind: "datatype"
status: "stable"
is_pii: true
categories: ["pii", "persons"]
country: ["US"]
langs: ["en"]
aliases: ["ssn"]
quality: 65
url: "http://registry.apicrafter.io/datatype/usssn"
---

# US Social Security Number (`usssn`)

In the United States, a Social Security number (SSN) is a nine-digit number issued to U.S. citizens, permanent residents, and temporary (working) residents under section 205(c)(2) of the Social Security Act, codified as 42 U.S.C. § 405(c)(2)

- Personal data (PII): yes
- Categories: Personally identifiable information (pii), Person related (persons)
- Countries: United States (US)
- Languages: English (en)
- Classification: identifier
- Former IDs: `ssn`

## Detection

Regular expression (Python `re`):

```
([0-9]{3})[- .]([0-9]{2})[- .]([0-9]{4})
```

## Mappings

- autotype: `ssn`, `ssn - new`
- dpv: `pd:OfficialID`
- fhir: `http://hl7.org/fhir/sid/us-ssn`
- fta: `SSN`
- google_dlp: `US_SOCIAL_SECURITY_NUMBER`
- presidio: `US_SSN`
- purview: `U.S. social security number (SSN)`
- stdnum: `us.ssn`

## Metacrafter rules

6 rules: 3 match the field name, 3 match values.

- `enssnfield` (field, `pii/us/us_pii.yaml`)
- `enssnvalue` (data, `pii/us/us_pii.yaml`)
- `usssnfield` (field, `pii/us/us_pii.yaml`)
- `usssnvalue` (data, `pii/us/us_pii.yaml`)
- `us_persons_usssnfield` (field, `us/us_persons.yaml`)
- `us_persons_usssnvalue` (data, `us/us_persons.yaml`)

## Supported by tools

- `alteryxdesignercloud`
- `amazonmacie`
- `autotype`
- `awscomprehend`
- `awsglue`
- `azureailanguage`
- `collibra`
- `databricks`
- `datahub`
- `dataprofiler`
- `fta`
- `googledlp`
- `greatexpectations`
- `ibmguardium`
- `ibmknowledgecatalog`
- `metacrafter`
- `microsoftpurview`
- `nightfall`
- `openmetadata`
- `oracleanalyticsdesktop`
- `oracledatasafe`
- `piicatcher`
- `presidio`
- `pythonstdnum`
- `snowflake`
- `sqldatacatalog`
- `talend`

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Social_Security_number>

## Quality

Score 65/100. Missing: anchored regexp, examples, negative example, translation.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/usssn.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/US/persons/usssn.yaml>