Skip to content
  • Validate SSNs

    Request

    Submit a batch request to check if the Social Security Numbers are within the acceptable range, and match against the First and Last Name.

    Headers
    Acceptstringrequired

    Format of the response.

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

    Format of the request.

    Enum:"application/json""application/xml"
    Bodyapplication/jsonrequired
    TransmissionReferencestring

    Serves as a unique request identifier.

    CustomerIdstringrequired

    Required. The License Key issued by Melissa.

    RecordsArray of objects, [ 1 .. 100 ] itemsrequired
    curl -i -X POST \
      https://namessn.melissadata.net/v4/web/SSN/doLookup \
      -H 'Accept: application/json' \
      -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
    Response
    { "TransmissionResults": "", "TransmissionReference": "", "Version": "6.2.0.1028", "TotalRecords": "1", "Records": [ { … } ] }