Skip to content
/Lookup From List

Reverse GeoCoder

Overview

The Reverse GeoCoder Cloud API provides the closest valid address(s), based on an input latitude and longitude. You can set the distance from the input coordinates (to reduce the number of returned output addresses) and a maximum number of records to be returned by the service.

Reverse GeoCoder can be used to:

  • Create a mailing list within a specific radius for targeted marketing.
  • Use in mobile apps for emergency location purposes & provide roadside help.
  • Identify the closest valid address(es) based on an input latitude and longitude
  • Provide the closest Postal Code(s), Carrier Route(s) or Plus4(s) based on an input latitude and longitude.
  • Create a dealer locator: Provide the closest valid address, Melissa Address Key (MAK) and distance from a provided list of MAKs based on an input latitude and longitude or MAK.

Documentation

Useful Resources

Product Page

https://www.melissa.com/geocoding

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
reverse-geocoder.json
reverse-geocoder.yaml
Languages
Servers
Reverse GeoCoder Server
https://reversegeo.melissadata.net/v3/web/ReverseGeoCode/

Lookup Addresses

Use this endpoint to lookup addresses closest to the input coordinates.

Operations

Lookup Postal Codes

Use this endpoint to lookup postal codes closest to the input coordinates.

Operations

Lookup From List

Use this endpoint to take in an origin address and one or more target address(es) to perform a distance comparison and 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.

Bodyapplication/jsonrequired
CustomerIdstringrequired

The License Key issued by Melissa.

Latitudestringrequired

The latitude geographic coordinate in decimal format.

Longitudestringrequired

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 options allows you to include records with a non-null baseMAK. Default of Off will not include non-null baseMAK records.
  • IncludeEmptyLots:< On | Off > - This options 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 options 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
Records[].​MelissaAddressKeystringrequired

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.

Records[].​RecordIDstring

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.

TransmissionReferencestring

Serves as a unique request identifier.

curl -i -X POST \
  https://reversegeo.melissadata.net/v3/web/ReverseGeoCode/doLookupFromList \
  -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(FromListRecord)
Response
application/json
{
  "Version": "6.2.0.5179",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "Results": "GS07",
  "TotalRecords": 1,
  "Records": [
    { … }
  ]
}