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 |