# 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**
* [Reverse GeoCoder Documentation](https://docs.melissa.com/cloud-api/reverse-geocoder/reverse-geocoder-index.html)

**Useful Resources**
* [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://md-developer-portal-staging.redocly.app/_bundle/apis/reverse-geocoder.yaml)

## Lookup Addresses

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

### Lookup an address from geo location

 - [GET /doLookup](https://md-developer-portal-staging.redocly.app/apis/reverse-geocoder/lookup-addresses/dolookupget.md): Uses HTTP GET to accept one input record and returns the response in JSON or XML format.

### Lookup an address from geo location

 - [POST /doLookup](https://md-developer-portal-staging.redocly.app/apis/reverse-geocoder/lookup-addresses/dolookuppost.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.

## Lookup Postal Codes

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

### Lookup a postal code from geo location

 - [GET /doLookupPostalCodes](https://md-developer-portal-staging.redocly.app/apis/reverse-geocoder/lookup-postal-codes/dolookuppostalcodesget.md): Uses HTTP GET to accept one input record and returns the response in JSON or XML format.

### Lookup postal codes from geo location

 - [POST /doLookupPostalCodes](https://md-developer-portal-staging.redocly.app/apis/reverse-geocoder/lookup-postal-codes/dolookuppostalcodespost.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.

## 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.

### Lookup addresses from a list of possible targets

 - [POST /doLookupFromList](https://md-developer-portal-staging.redocly.app/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.