Skip to content
On this page

SSN Append 007 US

Compatible Cases

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 NameTypeLengthOptional/MandatoryNotes
ForenameString15Mandatory
SurnameString15Mandatory
DayOfBirthInteger2OptionalMandatory if no PersonalId given
MonthOfBirthInteger2OptionalMandatory if no PersonalId given
HouseNameString26OptionalMandatory if no HouseNumber given
HouseNumberString26OptionalMandatory if no HouseName given
PostcodeString5MandatoryUSA zip code
StreetString40Mandatory
RegionInteger2MandatoryUSA state such as OH
CityString20Mandatory
CountryString3MandatoryMust be USA
MobileNumberInteger100Optional
EmailString100Optional
PersonalIdInteger4OptionalMandatory 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 NameTypeDescription
DOBStringFull DOB of matched customer.
FullMatchBoolTRUE if the passed details exactly match the resulted data, FALSE otherwise.
SSNStringFull SSN of matched customer.
WarningMessageStringA message to indicate which data is not fully matching the resulted data.

Sandbox

ForenameSurnameEmailPersonalIdDayOfBirthMonthOfBirthMobileNumberHouseNameStreetCityRegionCountryPostcode
DeannaReeder[email protected]**Null**070240412345675418Villa Downs AveDecaturGAUSA30030
DeannaReeder[email protected]**Null**060240412345675418Villa Downs AveDecaturGAUSA30030
DeannaReeder[email protected]**1234**NullNull40412345675418Villa Downs AveDecaturGAUSA30030
DeannaReeder[email protected]**1235**NullNull40412345675418Villa Downs AveDecaturGAUSA30030
DeannaReeder[email protected]**0000**NullNull40412345675418Villa Downs AveDecaturGAUSA30030