# Reverse Geocode API

Last updated:

<!-- -->

October 18, 2026

<!-- -->

\| 3 minutes read

<br />

<br />

[v](/docs/cloud-rest-api/guides/locations-search/CHANGELOG/)

<!-- -->

[1.0.2 Release notes →](/docs/cloud-rest-api/guides/locations-search/CHANGELOG/)

<br />

<br />

The Reverse Geocode API returns detailed address information for a given location coordinate. This powerful service converts coordinates to addresses (reverse geocoding), making it essential for location-based applications, delivery systems, store locators, and any service requiring precise geographic information.

:::info Complete API Reference View the complete [Reverse Geocode API Reference](/docs/cloud-rest-api/api/reverse-geocode-api.html) for detailed request/response schemas, examples, and interactive documentation. :::

***

**Endpoint:** `POST /revgeocode`

**Base URL:** `https://api.magiclane.net/api/v1`

### Key Features[​](#key-features "Direct link to Key Features")

* Convert coordinates to detailed addresses
* Search around a point, within an area, or along a path
* Returns multiple address results with distance ranking
* Includes administrative hierarchy (settlement, city, county, state, country)
* Identifies nearby map features including POIs, streets, and administrative areas

### Required Parameters[​](#required-parameters "Direct link to Required Parameters")

At least one geographic filter is required

### Optional Parameters[​](#optional-parameters "Direct link to Optional Parameters")

* `at` - Reverse geocode at a point coordinate `[longitude, latitude]`

* `in` - Reverse geocode within an area (polygon, circle, or bbox)

  <!-- -->

  * `polygon` - Polygon area defined by coordinates or polyline
  * `circle` - Circle area with center `[longitude, latitude]` and `radius` in meters
  * `bbox` - Bounding box with `east`, `west`, `south`, `north` coordinates

* `along` - Reverse geocode along a path with:

  <!-- -->

  * `polyline` - Encoded polyline path
  * `coords` - Array of coordinates defining the path
  * `radius` - Search radius around the path in meters

* `limit` - Maximum number of results to return (default: 15)

* `locale` - ISO 639-2 / ISO 639-3 language code for the result (default: `"en"`)

* `debug` - If `true`, the result is beautified for easy human read (default: `false`)

### Example Request - Reverse Geocode at Point[​](#example-request---reverse-geocode-at-point "Direct link to Example Request - Reverse Geocode at Point")

```bash
curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "at": [13.388860, 52.517037],
    "limit": 5
  }'

```

This returns address information for the specified coordinates.

### Example Request - Reverse Geocode in Area[​](#example-request---reverse-geocode-in-area "Direct link to Example Request - Reverse Geocode in Area")

```bash
curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "in": {
      "circle": {
        "center": [6.85524, 50.951736],
        "radius": 500
      }
    },
    "limit": 10
  }'

```

This finds all addresses and POIs within a 500m radius.

### Example Request - Reverse Geocode Along Path[​](#example-request---reverse-geocode-along-path "Direct link to Example Request - Reverse Geocode Along Path")

```bash
curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "along": {
      "coords": [
        [13.388860, 52.517037],
        [13.397634, 52.529407],
        [13.428555, 52.523219]
      ],
      "radius": 100
    },
    "limit": 20
  }'

```

This finds addresses along the specified path within 100m.

### Response Structure[​](#response-structure "Direct link to Response Structure")

The API returns a JSON array of objects, each containing:

* `info` - Copyright and attribution information

* `results` - Array of address objects, each containing:

  <!-- -->

  * `coordinates` - Location as `[longitude, latitude]`

  * `entrance` - Location entrance coordinates as `[longitude, latitude]` (when available)

  * `name` - Place or feature name

  * `address` - Detailed address components:

    <!-- -->

    * `street name` - Street name
    * `street number` - House/building number
    * `postal code` - Postal/ZIP code
    * `settlement` - Settlement/neighborhood
    * `city` - City name
    * `county` - County name
    * `state` - State/province name
    * `country` - Country name
    * `country code` - ISO country code

  * `contact` - Contact information (when available):

    <!-- -->

    * `URL` - Website URLs array
    * `Phone` - Phone numbers array
    * `Email` - Email addresses array

  * `distance` - Distance from search point in meters (when applicable)
