Social security number

Yoti offers the additional method of using a social security number (SSN) to verify a users age. This check is only available to individuals from the USA that have a social security number.

The Social security number method checks the basic identity details of a user can be matched to an known social security number in order to verify a user’s age. Yoti will send the user’s details, including their social security number to one of our data providers. 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.

IMPORTANT Please contact Yoti before enabling this method.

Endpoint

The API endpoint to request the social security number check for age:

POST https://age.yoti.com/api/v1/social-security-number/check

Headers

Request Body

The Social Security number can either be the full SSN or the last four digits. Both examples are shown below.

SCOPE A scope of address is required to use this check. This can be enabled through the Yoti Hub in the services section under your API key.

The JSON structure for the API request (payload):

{

  "type": "OVER", // optional

  "threshold": 18, // optional -> defaults to 18

  "first_name": "John",

  "last_name": "Doe",

  "zip_code": "123456",

  "social_security_number": "333-33-3333",

  "date_of_birth": "05/25/1984",

  "phone_number": "phone number",

  "street": "street name"

}

Response

{

  "transaction_id": "<some uuid>",

  "status": "<COMPLETE|ERROR|INSUFFICIENT_DATA>",

  "result": false|true, // <- deprecated

  "age": 0|18,

  "method": "SOCIAL_SECURITY_NUMBER",

  "type": "OVER"

}