Geocoding

Reverse geocode a coordinate

Changed on

Convert a lat/lon coordinate into the nearest OpenStreetMap place at the requested zoom level (0 country, 18 building). Intended for one-shot lookups, not live autocomplete. Data is (C) OpenStreetMap contributors (ODbL 1.0).

get/api/v1/geocoding/reverse

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/geocoding/reverse
  • Auth: API key in header x-api-key

Query parameters

latnumber required

Latitude in decimal degrees (WGS84).

lonnumber required

Longitude in decimal degrees (WGS84).

zoominteger

Address-detail zoom level: 0 country, 3 continent, 5 state, 8 county, 10 city, 14 suburb, 16 major street, 17 minor street, 18 building.

addressdetailsboolean

Include the structured address breakdown on the result.

Response

Nearest OSM place at the requested zoom, (C) OpenStreetMap contributors (ODbL 1.0).

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes