Social security number

AI Tools

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

Important Please contact Yoti before enabling this method.

Request body

{ "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

{ "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	`COMPLETE` - The SSN was verified to be over the threshold `ERROR` - No match found for the check `INSUFFICIENT_DATA` - No match found for the check (this will eventually replace the ERROR state)
age	The threshold of the check (18)
method	The method used. This should return as `Social_Security_Number`

Last updated on

Was this page helpful?