---
title: "Lookup addresses from a list of possible targets"
method: POST
path: "/doLookupFromList"
tags: ["Lookup From List"]
---

# Lookup addresses from a list of possible targets

`POST /doLookupFromList`

An HTTP POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response.

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

**Set A** - `Latitude`, `Longitude`

**Set B** - `MelissaAddressKey` (Request Level Parameter)

## Headers

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

## Request body

- FromListRequest
  - `CustomerId` string, required — Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.
  - `Latitude` string, required — Required. The latitude geographic coordinate in decimal format.
  - `Longitude` string, required — Required. The longitude geographic coordinate in decimal format.
  - `MaxDistance` string — The requested maximum distance in miles. The maximum value is `10`. Default is `10`.
  - `MaxRecords` string — The requested number of records. The maximum value is `100`. Default is `100`.
  - `Options` string — [Options](https://docs.melissa.com/cloud-api/reverse-geocoder/reverse-geocoder-reference-guide.html#reverse-geocoder-referenceguide-dolookupfromlist-options) - Specify which options to use for the selected action. List of options in `<OptionName>:<Parameter>` format. Multiple options are delimited with a `,`. For example: `OptionName:Parameter,OptionName:Parameter`. - `IncludeApartments:< On | Off >` - This option allows you to include records with a non-null baseMAK. Default of `Off` will not include non-null baseMAK records. - `IncludeEmptyLots:< On | Off >` - This option allows you to specify if you want to include addresses that are empty lots in your search. Default of `Off` will not include empty lots. - `IncludeUndeliverable:< On | Off >` - This option allows you to specify if you want to include addresses we have identified as unable to deliver mail to. Default of `On` will include undeliverable addresses.
  - `Records` object[], required
    - `MelissaAddressKey` string, required — Required. The Melissa Address Key (MAK) for a possible target address. You send in possible target addresses to lookup against the the origin address. You can send in more possible target addresses than your set `MaxRecords`.
    - `RecordID` string, required — Required. This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.
  - `TransmissionReference` string — Serves as a unique request identifier.

## Response `200`

Successful response

- FromListResponse
  - `Version` string — The current service version number.
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Reverse GeoCoder Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
  - `Results` string — Comma delimited status, error codes, and change codes for the record. For more information, see [Reverse GeoCoder Result Codes](https://docs.melissa.com/cloud-api/personator-search/result-codes.html).
  - `TotalRecords` integer — Total number of records.
  - `Records` FromListRecord[]
    - `AddressLine1` string — The street address.
    - `SuiteName` string — The suite name of the address returned.
    - `SuiteCount` string — The number of suites in a particular building.
    - `City` string — The city of the output address.
    - `State` string — The state of the output address.
    - `PostalCode` string — The postal code of the output address.
    - `AddressKey` string — A unique identifier for an address. This key can be used with other current and future Melissa Data services.
    - `Latitude` string — The latitude geographic coordinate of the output address.
    - `Longitude` string — The longitude geographic coordinate of the output address.
    - `Distance` string — The distance in miles between the input coordinates and the output coordinates.
    - `MelissaAddressKey` string — The Melissa Address Key (MAK). This is a globally unique and persistent key for the location, even if parts of the address change. When an address is fully validated this field returns a 10-digit proprietary key for the address.
    - `MelissaAddressKeyBase` string — The Melissa Address Key Base (BaseMAK). Every full address has its own Melissa Address Key (MAK). If that address is a suite or apartment, we will also return a Melissa Address Key Base (BaseMAK) that corresponds to the overall building.
    - `RecordID` string — The number of the record. Always 1 for a single request, otherwise it serves as an index of the array of records.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/melissa/apis/reverse-geocoder.md) · [All operations](https://skmtc.dev/melissa/apis/reverse-geocoder/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/melissa/reverse-geocoder/revisions/06423007a5d3/schema)