# Reverse Geocode

Canonical URL: https://doc.roote.ai/capabilities/geography/reverse-geocode



Convert coordinates into a readable place or address.

```http
GET https://api.roote.ai/v1/reverse-geocode
```

## Request [#request]

```bash
curl "https://api.roote.ai/v1/reverse-geocode?lat=48.8566&lon=2.3522" \\
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

| Parameter | Required | Description                 |
| --------- | -------- | --------------------------- |
| `lat`     | Yes      | Latitude from -90 to 90.    |
| `lon`     | Yes      | Longitude from -180 to 180. |

## Response [#response]

```json
{
  "results": [{
    "roote_id": null,
    "name": "Paris",
    "label": "Paris, France",
    "type": "locality",
    "location": { "lat": 48.8566, "lon": 2.3522 },
    "address": { "city": "Paris", "region": "Île-de-France", "country": "France" },
    "source_id": "google",
    "source_place_id": "provider-place-id"
  }],
  "meta": { "source": "google", "cache": "miss", "total": 1, "origin": { "lat": 48.8566, "lon": 2.3522 } }
}
```

Authenticated calls use the `geography:read` scope. Up to five ordered candidates may be returned. No result is HTTP 200 with an empty `results` array.