---
title: "Search individual person information"
method: GET
path: "/doPersonatorSearch"
tags: ["Personator Search"]
---

# Search individual person information

`GET /doPersonatorSearch`

The service requires at least one of the following input combinations:

**Set A** - `a1`, `postal`

**Set B** - `a1`, `city`, `state`

**Set C** - `ff`

**Set D** - `last`

**Set E** - `phone`

**Set F** - `email`

**Set G** - `mak`

**Set H** - `mik`

## Query parameters

- `t` string
- `format` 'JSON' | 'XML'
- `id` unknown, required
- `opt` string
- `cols` string
- `a1` string, required
- `ageapprox` string
- `agegt` string
- `agelt` string
- `bday` string
- `bmonth` string
- `byear` string
- `city` string, required
- `email` string
- `ff` string
- `first` string
- `full` string, required
- `last` string
- `mak` string
- `mik` string
- `phone` string
- `postal` string, required
- `state` string, required

## Headers

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

## Response `200`

Successful response.

- Response
  - `TransmissionResults` string — This is a string value that lists result codes from the web service. For more information, see [Personator Search Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `TotalPages` string — This is a string value containing the number of total pages returned by the request. The amount of records per page is set within the RecordsPerPage option.
  - `TotalRecords` string — This is a string value containing the number of total records returned by the request, up to a maximum of 500.
  - `Version` string — This is a string value that is the current revision number of Personator Search web service.
  - `Records` PersonatorSearchRecords[]
    - `RecordID` string — This is a string value that is a unique identifier for the current record if one was sent in the request. Use this element to match a request record and the corresponding response record.
    - `Results` string — This is a string value that lists result codes for the most recent request as a whole. For more information, see [Personator Search Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
    - `FullName` string — Returns the full name.
    - `FirstName` string — Returns the first name.
    - `MiddleName` string — Returns the middle name.
    - `LastName` string — Returns the last name.
    - `Suffix` string — This returns any part of the name that follows the family name, such as degrees (“MD” or “PhD”) and generational indicators (“IV” or “Jr.”)
    - `DateOfBirth` string — Returns the date of birth in the format `YYYYMM`. Accuracy is only to the month.
    - `DateOfDeath` string — This is a string value of the date of death of the individual. `YYYYMMDD` Format.
    - `MelissaIdentityKey` string — Returns a unique key associated with a person.
    - `CurrentAddress` CurrentAddress — The current address in an object container.
      - `AddressLine1` string — Returns address line 1.
      - `Suite` string — Returns the suite.
      - `City` string — Returns the city.
      - `State` string — State name of the current address.
      - `PostalCode` string — Postal code of the current address.
      - `Plus4` string — Plus4 of the current address.
      - `MelissaAddressKey` string — Returns a unique key associated with an address.
      - `MelissaAddressKeyBase` string — A unique key assigned to the base address of a complex with apartments or suites.
      - `MoveDate` string — Returns the date the individual moved-in to this address in the format `YYYYMMDD`.
    - `PreviousAddresses` PreviousAddress[] — This is an array container holding the previous address objects.
      - `AddressLine1` string — Returns address line 1.
      - `City` string — Returns the city.
      - `MelissaAddressKey` string — Returns a unique key associated with an address.
      - `MelissaAddressKeyBase` string — Returns a unique key associated with a building containing multiple suites/apartments.
      - `Plus4` string — Plus4 of the current address.
      - `PostalCode` string — Postal code of the current address.
      - `State` string — State name of the current address.
      - `Suite` string — Returns the suite.
      - `MoveDate` string — Returns the date the individual moved-out from this address in the format `YYYYMMDD`.
    - `EmailRecords` EmailRecord[] — This is an array container holding the email record objects.
      - `email` string — Returns the email address associated with the individual.
    - `PhoneRecords` PhoneRecord[] — This is an array container holding the phone record objects.
      - `phoneNumber` string — Returns the standardized phone number for the record.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/personator-search.md) · [All operations](https://skmtc.net/melissa/apis/personator-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/personator-search/revisions/ae2b8a54f1b4/schema)