Skip to content
  • Contribution
  • Data Retriever
  • 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.

    idany, (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"
    import requests

url = "https://namessn.melissadata.net/v4/web/SSN/doLookup"

query = {
  "id": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
  "ssn": "111222333",
  "first": "John",
  "last": "Doe"
}

headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.get(url, headers=headers, params=query)

data = response.json()
print(data)

    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": [
    { … }
  ]
}