Skip to main content
API reference

Reverse geocode

Find addresses and places near a latitude and longitude.

GET/v1/reverse

Send a latitude and longitude to get nearby addresses, streets, and places, ranked by proximity. Each result's distance_m is its distance from your point.

Headers​

HeaderRequiredValue
apikeyYesYour primary API key

Query parameters​

latnumberrequired

Latitude in [-90, 90]. Zero is valid.

lonnumberrequired

Longitude in [-180, 180]. Zero is valid.

radiusnumber

Search radius in meters, 1–100,000. Default 1,000. If fewer than limit addresses, streets, or places are within the radius, the neighborhood, city, county, state, and country containing the point fill the remaining results.

typesstring

Comma-separated result types to include, e.g. address.

limitinteger

Maximum results, 1–40. Default 10.

exclude_sourcesstring

Comma-separated source names to omit. See data sources.

Request example​

cURL
curl "$GEOCODING_BASE_URL/v1/reverse?lat=40.7074&lon=-74.0113&types=address&limit=1" \
  --header "apikey: $GEOCODING_API_KEY"

Success response​

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {"type": "Point", "coordinates": [-74.0112, 40.7073]},
      "properties": {
        "id": "openaddresses:address:us/ny:1",
        "label": "11 Wall Street, New York, NY, USA",
        "type": "address",
        "name": "11 Wall Street",
        "house_number": "11",
        "street": "Wall Street",
        "unit": null,
        "neighborhood": "Financial District",
        "city": "New York",
        "county": "New York County",
        "state": "NY",
        "state_name": "New York",
        "zip": "10005",
        "country": "US",
        "lat": 40.7073,
        "lon": -74.0112,
        "confidence": 0.95,
        "match_type": "exact",
        "distance_m": 14,
        "categories": [],
        "source": "openaddresses"
      }
    }
  ]
}

Result coordinates describe the returned address or place, which can differ from the point you sent. Reverse confidence reflects distance and is not the geocode match score.

No results returns 200 with "features": []. Successful responses carry X-Geocoding-Outcome: matched or no_match. See errors.