---
title: "Validate a SSN"
method: GET
path: "/doLookup"
tags: ["Validate SSN and Name"]
---

# Validate a SSN

`GET /doLookup`

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

## Query parameters

- `t` string
- `id` unknown, required
- `ssn` string, required
- `first` string, required
- `last` string, required
- `full` string
- `format` string

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- Response
  - `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` ResponseRecord[]
    - `RecordID` string — The record ID.
    - `SSN` string — The Social Security Number submitted for validation.
    - `IssuingState` string — The issuing state calculated by using the SSN Area Number (first 3 digits of the SSN).
    - `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).
    - `ResultsFromDataSource` string — Comma delimited status, error codes, and change codes from the Data Source.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/ssn-name-match.md) · [All operations](https://skmtc.net/melissa/apis/ssn-name-match/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/ssn-name-match/versions/9af8e50968b4/schema)