SSN Append 007 US
About the service
This service is a Social Security Number (SSN) lookup and verification service for the United States. It retrieves the full SSN and DOB of matching customers when a lookup is made using customers' data, and either the last 4 digits of SSN or partial DOB (Month and Day only).
Product Code: US-SSNappend-007
Does this service leave a credit search Footprint? No
Request
Properties
The following properties pertain to this service.
Property Name | Type | Length | Optional/Mandatory | Notes |
---|---|---|---|---|
Forename | String | 15 | Mandatory | |
Surname | String | 15 | Mandatory | |
DayOfBirth | Integer | 2 | Optional | Mandatory if no PersonalId given |
MonthOfBirth | Integer | 2 | Optional | Mandatory if no PersonalId given |
HouseName | String | 26 | Optional | Mandatory if no HouseNumber given |
HouseNumber | String | 26 | Optional | Mandatory if no HouseName given |
Postcode | String | 5 | Mandatory | USA zip code |
Street | String | 40 | Mandatory | |
Region | Integer | 2 | Mandatory | USA state such as OH |
City | String | 20 | Mandatory | |
Country | String | 3 | Mandatory | Must be USA |
MobileNumber | Integer | 100 | Optional | |
String | 100 | Optional | ||
PersonalId | Integer | 4 | Optional | Mandatory if no DayOfBirth and MonthOfBirth are given - Please add Last 4 digits of the SSN |
Response
Example Response
The following is an example service response:
json
"SSNAppend007Result": {
"DOB": "02/07/1952",
"FullMatch": false,
"SSN": "666501235",
"WarningMessage": "SSN was not fully matched"
}
Response Breakdown
Each of the properties describes the following:
Property Name | Type | Description |
---|---|---|
DOB | String | Full DOB of matched customer. |
FullMatch | Bool | TRUE if the passed details exactly match the resulted data, FALSE otherwise. |
SSN | String | Full SSN of matched customer. |
WarningMessage | String | A message to indicate which data is not fully matching the resulted data. |
Sandbox
Forename | Surname | PersonalId | DayOfBirth | MonthOfBirth | MobileNumber | HouseName | Street | City | Region | Country | Postcode | |
---|---|---|---|---|---|---|---|---|---|---|---|---|
Deanna | Reeder | [email protected] | **Null** | 07 | 02 | 4041234567 | 5418 | Villa Downs Ave | Decatur | GA | USA | 30030 |
Deanna | Reeder | [email protected] | **Null** | 06 | 02 | 4041234567 | 5418 | Villa Downs Ave | Decatur | GA | USA | 30030 |
Deanna | Reeder | [email protected] | **1234** | Null | Null | 4041234567 | 5418 | Villa Downs Ave | Decatur | GA | USA | 30030 |
Deanna | Reeder | [email protected] | **1235** | Null | Null | 4041234567 | 5418 | Villa Downs Ave | Decatur | GA | USA | 30030 |
Deanna | Reeder | [email protected] | **0000** | Null | Null | 4041234567 | 5418 | Villa Downs Ave | Decatur | GA | USA | 30030 |