Title
Create new category
Edit page index title
Edit category
Edit link
Social security number
This method is available through the:
- Age Verification UI
- or as a headless check.
US residents supply their name, date of birth, zip code and the last 4 digits of their social security number. A SSN can be used to retrieve the identity of the SSN holder, which is sufficient to determine the exact age of the person or whether they are an adult.
Suppliers verify if the SSN is real and matches the supplied details. It is unknown if these details may be in the permanent or temporary possession of someone who is not the owner.
Once the check is complete, the provider confirms the social security number can be linked to the validation identity which is then used to determine that the user is over the age threshold.
We never store or share the user’s details with anyone other than the provider.
This method is good for:
- Speed
- Specific countries
Request body
xxxxxxxxxx{ "type": "OVER", "social_security_number": { "allowed" : true, "threshold": 18 }, "ttl": 900, "reference_id": "over_18_example", "callback": { "auto": true, "url": "https://www.yoti.com" }, "notification_url": "https://yourdomain.example/webhook", "cancel_url": "https://www.yoti.com"}| Parameter | Types/Value | Description |
|---|---|---|
| allowed | true / false | Enable the verification method for the user to select. |
| threshold | Integer | Age threshold for AV method. Only a threshold of 18+ is supported for SSN. |
Example response
xxxxxxxxxx{ "transaction_id": "<uuid>", "type": "OVER", "status": "COMPLETE", "age": 18, "method": "SOCIAL_SECURITY_NUMBER",}| Field | Description |
|---|---|
| transaction_id | Unique ID related to the request check being performed. |
| type | The condition for the age check (Over threshold) |
| status |
|
| age | The threshold of the check (18) |
| method | The method used. This should return as Social_Security_Number |
Got a question? Contact us here.