v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Geocoding

Place detail with administrative hierarchy

Return administrative and topological detail for a single OpenStreetMap place. Provide either place_id (internal Nominatim identifier) OR the osm_type + osm_id pair (stable OSM identifier - preferred). osm_type accepts the single-letter form N (node), W (way), R (relation). Responses can be very large for famous places when the multilingual names map is populated. Intended for one-shot lookups, not live autocomplete. Data is (C) OpenStreetMap contributors (ODbL 1.0).

get/api/v1/geocoding/details

Query parameters

place_idinteger nullable

Internal Nominatim place identifier. Not stable across reindexes; prefer osm_type + osm_id for persistent references.

Internal Nominatim place identifier. Not stable across reindexes; prefer osm_type + osm_id for persistent references.

osm_typestring nullable

OSM element variant in single-letter form: N node, W way, R relation.

OSM element variant in single-letter form: N node, W way, R relation.

osm_idinteger nullable

Stable OpenStreetMap identifier within the osm_type namespace.

Stable OpenStreetMap identifier within the osm_type namespace.

addressdetailsboolean

Include the structured address breakdown on the result.

Include the structured address breakdown on the result.

Response

Administrative hierarchy and metadata for one place, (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",
    "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"
    ]
  }
}