# Validate SSNs

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.

Endpoint: POST /doLookup

## Request fields (application/json):

  - `TransmissionReference` (string)
    Serves as a unique identifier for this set of records. This allows you to match a response to a request.

  - `CustomerId` (string, required)
    The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.

  - `Records` (array, required)

  - `Records.RecordID` (string)
    The record ID.

  - `Records.SSN` (string, required)
    The SSN to be verified.

  - `Records.FirstName` (string)
    The given (first) name.

  - `Records.LastName` (string)
    The family (last) name.

  - `Records.FullName` (string)
    The full name - Only parsed if the First Name and Last Name fields are left blank.

## Response 200 fields (application/json):

  - `TransmissionResults` (string)
    Lists error codes from any errors caused by the most recent request as a whole. For more information, see [SSN Name Match Result Codes](https://docs.melissa.com/cloud-api/ssn-name-match/result-codes.html).

  - `TransmissionReference` (string)
    A pass-through of the input TransmissionReference field.

  - `Version` (string)
    The current service version number.

  - `TotalRecords` (string)
    Total number of records.

  - `Records` (array)

  - `Records.RecordID` (string)
    The record ID.

  - `Records.SSN` (string)
    The Social Security Number submitted for validation.

  - `Records.IssuingState` (string)
    The issuing state calculated by using the SSN Area Number (first 3 digits of the SSN).

  - `Records.Results` (string)
    Comma delimited status, error codes, and change codes for the record. For more information, see [SSN Name Match Result Codes](https://docs.melissa.com/cloud-api/ssn-name-match/result-codes.html).

  - `Records.ResultsFromDataSource` (string)
    Comma delimited status, error codes, and change codes from the Data Source.

## Response 400 fields (application/json):

  - `type` (string)
    The type of error that occurred.

  - `title` (string)
    A short summary of the error.

  - `status` (integer)
    The HTTP status code for the error.

  - `errors` (object)

  - `errors.$.<PropertyName>` (array)
    A detailed message about the error.

  - `traceId` (string)
    A unique identifier for the request, useful for debugging.