v5

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

Fetch places by OSM identifiers

Resolve up to 50 OpenStreetMap elements by their stable (type, id) pairs. osm_ids is a comma-separated list of tokens in the form N<id> (node), W<id> (way), or R<id> (relation). Intended for one-shot lookups, not live autocomplete. Data is (C) OpenStreetMap contributors (ODbL 1.0).

get/api/v1/geocoding/lookup

Query parameters

osm_idsstring required

Comma-separated OSM identifiers. Each token is N<int> node, W<int> way, or R<int> relation. Maximum 50 tokens per call.

Comma-separated OSM identifiers. Each token is N<int> node, W<int> way, or R<int> relation. Maximum 50 tokens per call.

addressdetailsboolean

Include the structured address breakdown on every result.

Include the structured address breakdown on every result.

Response

Places keyed by OSM identifier, (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"
    ]
  }
}