Receive the result back for all records from the input.
NOTE: It expects UTF-8 character encoding. Be on the lookout for question marks (?), squares (▖) or other weird characters like �. They may be an indication of encoding issues and may result in data loss. Bad encoding or character loss is not something our service can correct for you.
With a REST request, you can include all the input along with the URL for an easy and quick way of sending a single record.
C:\>curl -X GET “https://namessn.melissadata.net/v4/WEB/SSN/doLookup?id=LICENSE_KEY&SSN=SOCIAL_SECURITY_NUMBER&full=FULL_NAME&first=FIRST_NAME&last=LAST_NAME&t=Lookups&format=json”
You can also put the URL without the "curl -X GET" command directly into your browser. This service will only return a JSON result. You can also use JSON POST to send requests.
Service Errors (SE Codes) and General Transmission Errors (GE Codes).
Returned value will be the same as the input TransmissionReference to be used as a unique identifier.
The current revision number of SSN Verification.
The total number of records returned.
Unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
Returned string value of the Social Security Number submitted for validation.
A string value of the issued state calculated by using the SSN Area Number (first 3 digits of the SSN).
A string value with comma delimited status, error codes, and change codes for the record.
For a complete list of codes, see SSN Web Service Result Codes.
The SSN Verification API and other Melissa APIs will have a Results Output. Several different Result Codes may be returned by the service in order to give you detailed information about the status of the record submitted.
It is important to understand these result codes in order for you to make a determination of good vs bad data and how you would want to use it.
The following shows you the indicators for the different results:
SSN and FULL name match our records
SSN and LAST name match our records
SSN and FIRST name match our records
SSN and Last Name, First Name Initial match our records