Skip to content
GET /v1/reverse

Reverse geocoding (coordinates → address)

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/geocoding-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/geocoding-api/v1/reverse" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/geocoding-api/v1/reverse", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/geocoding-api/v1/reverse");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/geocoding-api/v1/reverse",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "lat": 52.5163,
        "lon": 13.3777,
        "place": {
            "lat": 52.51627,
            "lon": 13.3777021,
            "name": "Quadriga with Victoria",
            "type": "artwork",
            "osm_id": 3786417057,
            "address": {
                "city": "Berlin",
                "road": "Platz des 18. März",
                "suburb": "Mitte",
                "borough": "Mitte",
                "country": "Germany",
                "quarter": "Friedrich-Wilhelm-Stadt",
                "tourism": "Quadriga with Victoria",
                "postcode": "10117",
                "country_code": "de",
                "ISO3166-2-lvl4": "DE-BE"
            },
            "category": "tourism",
            "osm_type": "node",
            "place_id": 145366925,
            "importance": 8.875486381318407e-5,
            "place_rank": 30,
            "addresstype": "tourism",
            "boundingbox": [
                52.51622,
                52.51632,
                13.3776521,
                13.3777521
            ],
            "display_name": "Quadriga with Victoria, Platz des 18. März, Friedrich-Wilhelm-Stadt, Mitte, Berlin, 10117, Germany"
        }
    },
    "meta": {
        "timestamp": "2026-05-29T20:06:48.772Z",
        "request_id": "f36f1f46-fa26-4b1c-a0ee-545ddcaec5ae"
    },
    "status": "ok",
    "message": "Reverse geocoding retrieved successfully",
    "success": true
}