SSN Verification

The Jumio eKYC SSN (Social Security Number) verification service allows a customer to submit personal identifiable information from applicants within the United States. The SSN verification service confirms that a name, address, and Social Security Number are valid and connected to the end user.

This service connects to US data sources such as credit bureaus, SSA, utilities, telecom, USPS, bell companies, and other proprietary sources.

Service Name	Description	Required Fields	Verifiable Fields
SSN Verification	Input is verified against the US data sources such as credit bureaus, SSA, utilities, telecom, USPS, bell companies, and other proprietary sources.	Name, Address and SSN; Optional: Date of Birth (DOB)	Name, Address, SSN, DOB, Phone, Deceased Indicator

Supported Credentials

The following values can be uploaded as Prepared Data. Alternatively, they can be extracted by an upstream capability in a workflow.

Details

Key	Type	Mandatory	Description
firstName	string	yes	First name of the subject
lastName	string	yes	Last name of the subject
middleName	string	no	Middle name of the subject
paternalSurname	string	no	Paternal surname of the subject
maternalSurname	string	no	Maternal surname of the subject
sex	string	no	Sex of the subject (e.g., M - Male, F - Female)
email	string	no	Email address of the subject
phoneNumber	string	no	Phone number of the subject in E.164 format
ipAddress	string	no	IP address of the subject
socialSecurityNumber	string	yes	Social Security Number (4 or 9 digits)
dateOfBirth	LocalDate	no	Date of birth in YYYY-MM-DD format
address	Object	yes	Only the fields mentioned below are required
address.line1	string	yes	Address line 1
address.line2	string	yes	Address line 2
address.city	string	yes	City of the subject
address.postalCode	string	yes	Postal code (Zip code)
address.subdivision	string	yes	Subdivision (State)
address.country	string	yes	Country in ISO Alpha 3 Code format

Example Prepared Data Body

{
    "firstName": "xxxxx",
    "lastName": "xxxx",
    "middleName": "",
    "sex": "M",
    "nationality": "",
    "phoneNumber2": "",
    "phoneNumber": "+555****333",
    "ipAddress": "54.190.251.42",
    "socialSecurityNumber": "123*****",
    "dateOfBirth": "1970-01-31",
    "address": {
      "line1": "123 main street",
      "postalCode": "9***6"
        }
  }

Response

Response data is available for transactions that include the risk signal. For information on transaction data see Viewing or Retrieving Workflow Transactions.

Example Response

ekycSsnVerification": [
     {
         "id": "4da5f259-aaed-4fd9-8283-6a02d5a18476",
         "credentials": [
             {
                 "id": "a94b913f-3fde-4f98-898f-88a0cbaef8b8",
                 "category": "DATA"
             }
         ],
         "decision": {
             "type": "WARNING",
             "details": {
                 "label": "MEDIUM_RISK"
             }
         },
         "data": {
             "addressMatch": "match",
             "nameMatchToSsn": "match",
             "nameMatchToAddress": "partial-match",
             "phoneMatch": "no-match",
             "ssnMatch": "match",
             "dateOfBirthMatch": "no-match",
             "isDeceased": false,
             "isSSNIssuedPriorYOB": false
         }
}

Decision Details Labels

Details

Decision Type	Label	Description
NOT_EXECUTED	PRECONDITION_NOT_FULFILLED	Provided data is incorrectly formatted.
NOT_EXECUTED	NOT_ENOUGH_DATA	Required data is not available.
NOT_EXECUTED	TECHNICAL_ERROR	The service encountered an error and was unable to process the request.
PASSED	LOW_RISK	Provided data matches available records.
WARNING	MEDIUM_RISK	Partial matches of provided name to address.
REJECTED	HIGH_RISK	Provided data does not match available records.

Data

Details

Key	Type	Description
addressMatch	string	match, no-match, partial-match
nameMatchToSsn	string	match, no-match, partial-match
nameMatchToAddress	string	match, no-match, partial-match
phoneMatch	string	match, no-match, partial-match
ssnMatch	string	match, no-match, partial-match
dateOfBirthMatch	string	match, no-match, partial-match
isDeceased	string	The SSN belongs to a deceased person: true, false
isSSNIssuedPriorYOB	string	The SSN was issued by the SSA prior to the provided Year of Birth: true, false