# Reverse GeoCoder

## Reverse GeoCoder Overview ##
The Reverse GeoCoder Cloud API provides the closest valid address(es), 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**
* [Reverse GeoCoder Documentation](https://docs.melissa.com/cloud-api/reverse-geocoder/reverse-geocoder-index.html)

**Useful Resources**
* [GitHub - Reverse GeoCoder Open API Specification](https://github.com/MelissaData/MelissaCloudAPI-OpenAPI-Specification/blob/main/openapi/apis/reverse-geocoder.yaml)
* [Release notes](https://releasenotes.melissa.com/cloud-api/reverse-geocoder/)
* [Result codes](https://docs.melissa.com/cloud-api/reverse-geocoder/result-codes.html)

**Product Page**

[https://www.melissa.com/geocoding](https://www.melissa.com/geocoding)

**Support Center**

[https://www.melissa.com/company/product-support](https://www.melissa.com/company/product-support)



## Servers

Reverse GeoCoder Server
```
https://reversegeo.melissadata.net/v3/web/ReverseGeoCode
```

## Download OpenAPI description

[Reverse GeoCoder](https://developer.melissa.com/_bundle/apis/reverse-geocoder.yaml)

## Lookup Addresses

Use Lookup Addresses endpoint to lookup addresses closest to the input coordinates.

### Lookup addresses from geo location

 - [GET /doLookup](https://developer.melissa.com/apis/reverse-geocoder/lookup-addresses/dolookupget.md): Send a GET request to lookup addresses from geo location.

### Lookup addresses from geo location

 - [POST /doLookup](https://developer.melissa.com/apis/reverse-geocoder/lookup-addresses/dolookuppost.md): Send a bulk request to lookup addresses from geo location.

## Lookup Postal Codes

Use Lookup Postal Codes endpoint to lookup postal codes closest to the input coordinates.

### Lookup a postal code from geo location

 - [GET /doLookupPostalCodes](https://developer.melissa.com/apis/reverse-geocoder/lookup-postal-codes/dolookuppostalcodesget.md): Send a GET request to lookup a postal code from geo location.

### Lookup postal codes from geo location

 - [POST /doLookupPostalCodes](https://developer.melissa.com/apis/reverse-geocoder/lookup-postal-codes/dolookuppostalcodespost.md): Send a bulk request to lookup postal codes from geo location.

## Lookup From List

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

### Lookup addresses from a list of possible targets

 - [POST /doLookupFromList](https://developer.melissa.com/apis/reverse-geocoder/lookup-from-list/dolookupfromlistpost.md): 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)