Skip to content
/Validate SSN and Name

SSN Name Match

Overview

The SSN Name Match Cloud API determines if the Social Security Number is within the acceptable range, and matches against the First and Last Name. In addition, the Cloud API will also check if the SSN is flagged as deceased.

You can use SSN Name Match to:

  • Verify SSN syntax is correct
  • Verify the SSN exists
  • Match First and Last Name to the SSN
  • Perform deceased suppression based upon SSN

Documentation

Useful Resources

Product Page

https://www.melissa.com/ssn-name-match

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
ssn-name-match.json
ssn-name-match.yaml
Languages
Servers
SSN Name Match Server
https://namessn.melissadata.net/v4/web/SSN/

Validate SSN and Name

Use this endpoint to check if the Social Security Number is within the acceptable range, and match against the First and Last Name.

Operations

Validate a SSN

Request

Uses HTTPS GET to accept one input record and returns the response in JSON format.

Query
tstring

Transmission Reference - Optional. Serves as a unique identifier for this set of records.

idany(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
ssnstringrequired

Social Security Number - All hyphens are ignored when submitting the SSN. We recommended using only numbers when submitting the SSN.

Example: ssn=111222333
firststringrequired

The given (first) name.

Example: first=John
laststringrequired

The family (last) name.

Example: last=Doe
fullstring

The full name - Only parsed if the First Name and Last Name fields are left blank.

Example: full=John Doe
formatstring

Sets the format of the response.

Example: format=json
curl -i -X GET \
  'https://namessn.melissadata.net/v4/web/SSN/doLookup?id={REPLACE-WITH-YOUR-LICENSE-KEY}&ssn=111222333&first=John&last=Doe'

Responses

Successful response

Bodyapplication/json
TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see SSN Name Match Result Codes.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

Versionstring

The current service version number.

TotalRecordsstring

Total number of records.

RecordsArray of objects(ResponseRecord)
Response
application/json
{
  "TransmissionResults": "",
  "TransmissionReference": "",
  "Version": "6.2.0.1028",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}

Validate SSNs

Request

An HTTPS POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response.

Bodyapplication/jsonrequired
TransmissionReferencestring

Serves as a unique identifier for this set of records. This allows you to match a response to a request.

CustomerIdstringrequired

The License Key issued by Melissa.

RecordsArray of objects(RequestRecord)[ 1 .. 100 ] itemsrequired
Records[].​RecordIDstring

The record ID.

Records[].​SSNstringrequired

The SSN to be verified.

Records[].​FirstNamestring

The given (first) name.

Records[].​LastNamestring

The family (last) name.

Records[].​FullNamestring

The full name - Only parsed if the First Name and Last Name fields are left blank.

curl -i -X POST \
  https://namessn.melissadata.net/v4/web/SSN/doLookup \
  -H 'Content-Type: application/json' \
  -d '{
    "TransmissionReference": "test",
    "CustomerId": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Records": [
      {
        "FirstName": "John",
        "FullName": "John Doe",
        "LastName": "Doe",
        "RecordID": "1",
        "SSN": "111222333"
      }
    ]
  }'

Responses

Successful response

Bodyapplication/json
TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see SSN Name Match Result Codes.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

Versionstring

The current service version number.

TotalRecordsstring

Total number of records.

RecordsArray of objects(ResponseRecord)
Response
application/json
{
  "TransmissionResults": "",
  "TransmissionReference": "",
  "Version": "6.2.0.1028",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}