---
title: "`GET /geocode/retrieve?id=<document id>`."
method: GET
path: "/geocode/retrieve"
tags: ["geocoding"]
---

# \`GET /geocode/retrieve?id=<document id>\`.

`GET /geocode/retrieve`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/geocode/retrieve`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `id` string, required

## Response `200`

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

- object

## Other responses

- `400`: Missing or over-long `id`
- `401`: Missing or invalid API key
- `404`: No document carries that id: it was never issued, or the index has been rebuilt since it was. For a `ukpc:`, `iepc:`, `nlpc:` or `photon:` id, no source knows that postcode or address any more. The body's `detail` says to search again and re-pick
- `429`: Quota or rate limit exceeded
- `501`: This deployment has no first-party geocode index, or its index predates the document-id field (`urn:sn-gateway:problem:suggest-not-enabled`). Reserved `ukpc:` postcode ids are resolved either way
- `502`: A reserved id needed the forward geocoder and the request to it failed

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)