# Validate a SSN

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

Endpoint: GET /doLookup

## Query parameters:

  - `t` (string)
    Transmission Reference - Optional. Serves as a unique identifier for this set of records.

  - `id` (any, required)
    The License Key issued by Melissa.
    Example: "{REPLACE-WITH-YOUR-LICENSE-KEY}"

  - `ssn` (string, required)
    Social Security Number - All hyphens are ignored when submitting the SSN. We recommended using only numbers when submitting the SSN.
    Example: "111222333"

  - `first` (string, required)
    The given (first) name.
    Example: "John"

  - `last` (string, required)
    The family (last) name.
    Example: "Doe"

  - `full` (string)
    The full name - Only parsed if the First Name and Last Name fields are left blank.
    Example: "John Doe"

  - `format` (string)
    Sets the format of the response.
    Example: "json"

## 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.