GET/geocode/retrieve

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/geocode/retrieve?id=…" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

Name	In	Required	Description
id	query	yes	A document id, exactly as `GET /geocode/suggest` or `GET /geocode` reported it. Matched verbatim (no folding, trimming or case change), so an edited id is a 404, never a near-miss served as though it were the real thing

Responses

200A Photon-compatible GeoJSON FeatureCollection carrying exactly one feature: the same shape, and the same property set, that GET /geocode returns for this document

400Missing or over-long id

401Missing or invalid API key

404No document carries that id: it was never issued, or the index has been rebuilt since it was. The body's detail says to search again and re-pick

429Quota or rate limit exceeded

501This deployment has no first-party geocode index, or its index predates the document-id field (urn:sn-gateway:problem:suggest-not-enabled)

Error bodies follow the shared problem model documented on API conventions.

Also under geocoding

GET /geocode POST /geocode/batch GET /geocode/reverse GET /geocode/suggest

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId get_geocode_retrieve