Skip to content
  • Contribution
  • Data Retriever
  • Global Address Verification
  • Global Email
  • Global Express Entry
  • Global IP
  • Global Name
  • Global Phone
  • LeadGen - Business
  • LeadGen - Consumer
  • LeadGen - Occupant
  • LeadGen - Property
  • Melissa Releases
  • People Business Search
  • Personator Consumer
  • Personator Identity
  • Personator Search
  • Property
  • Reverse GeoCoder
  • Lookup Addresses
  • Lookup Postal Codes
  • Lookup From List
  • SmartMover CA
  • SmartMover US
  • SSN Name Match
  • Street Route
  • Token Server
  • US Business Coder
  • Usage

    • Lookup From List

    Use Lookup From List endpoint to return the closest target address(es) to the origin address.

    Operations

    Lookup addresses from a list of possible targets

    Request

    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
    Acceptstringrequired

    Format of the response.

    Enum:"application/json""application/xml""*/*"
    Example:*/*
    Content-Typestringrequired

    Format of the request.

    Enum:"application/json""application/xml"
    Bodyapplication/jsonrequired
    CustomerIdstringrequired

    Required. The License Key issued by Melissa.

    Latitudestringrequired

    Required. The latitude geographic coordinate in decimal format.

    Longitudestringrequired

    Required. The longitude geographic coordinate in decimal format.

    MaxDistancestring

    The requested maximum distance in miles. The maximum value is 10. Default is 10.

    MaxRecordsstring

    The requested number of records. The maximum value is 100. Default is 100.

    Optionsstring

    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.
    RecordsArray of objects, [ 1 .. 100 ] itemsrequired
    TransmissionReferencestring

    Serves as a unique request identifier.

    curl -i -X POST \
  https://reversegeo.melissadata.net/v3/web/ReverseGeoCode/doLookupFromList \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
    "CustomerId": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Latitude": "33.63756710910554",
    "Longitude": "-117.60695049134513",
    "MaxDistance": "10",
    "MaxRecords": "",
    "Options": "",
    "Records": [
      {
        "MelissaAddressKey": "8008006245",
        "RecordID": "1"
      },
      {
        "MelissaAddressKey": "5328287925",
        "RecordID": "2"
      }
    ],
    "TransmissionReference": "Reverse Geo LookupFromList Test"
  }'

    Responses

    Successful response

    Bodyapplication/json
    Versionstring

    The current service version number.

    TransmissionReferencestring

    A pass-through of the input TransmissionReference field.

    TransmissionResultsstring

    Lists error codes from any errors caused by the most recent request as a whole. For more information, see Reverse GeoCoder Result Codes.

    Resultsstring

    Comma delimited status, error codes, and change codes for the record. For more information, see Reverse GeoCoder Result Codes.

    TotalRecordsinteger

    Total number of records.

    RecordsArray of objects
    Response
    {
  "Version": "6.2.0.5179",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Results": "GS07",
  "TotalRecords": 1,
  "Records": [
    { … }
  ]
}