Skip to content
  • Data Retriever
  • Elected Officials
  • Global Address Verification
  • Global Email
  • Global Express Entry
  • Global IP
  • Global Name
  • Global Phone
  • LeadGen - Business
  • LeadGen - Consumer
  • LeadGen - Occupant
  • LeadGen - Property
  • Melissa Releases
  • People Business Search
  • Personator Consumer
  • Personator Identity
  • Personator Search
  • Property
  • Reverse GeoCoder
  • SmartMover CA
  • SmartMover US
  • SSN Name Match
  • Validate SSN and Name
  • Validate SSNs
    post
  • Street Route
  • Token Server
  • US Business Coder
  • Usage

    • Validate a SSN

    Request

    Check if the Social Security Number is within the acceptable range, and match against the First and Last Name.

    Query
    tstring

    Transmission Reference - Serves as a unique request identifier.

    idstring, (password)required

    Required. The License Key issued by Melissa.

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

    Required. This is a string value containing the Social Security Number. All hyphens are ignored when submitting the SSN. We recommended using only numbers when submitting the SSN.

    Example:ssn=111222333
    firststringrequired

    Required. The given (first) name.

    Example:first=John
    laststringrequired

    Required. The family (last) name.

    Example:last=Doe
    fullstring

    Required. This field can contain a full name. We will parse and check Names only 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
    Headers
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""*/*"
    Example:application/json
    Content-Typestringrequired

    Format of the request.

    Enum:"application/json""application/xml"
    curl -i -X GET \
  'https://namessn.melissadata.net/v4/web/SSN/doLookup?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&ssn=111222333&first=John&last=Doe' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'

    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
    Response
    {
  "TransmissionResults": "",
  "TransmissionReference": "",
  "Version": "6.2.0.1028",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}