POST/geocode/batch

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

Call it

bash

curl -fsS -X POST "https://api.mapmap.ai/geocode/batch" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · GeocodeBatchRequest

Field	Type	Required	Description
queries	GeocodeBatchQuery[]	yes	The queries, up to [`MAX_BATCH_QUERIES`]. Order is preserved in the response.

Responses

200One result per query, in request order. Each carries either features (the same GeoJSON FeatureCollection the single endpoints return, match object included when the entry named structured components) or problem (an RFC 9457 object describing what went wrong with THAT entry). A failing entry never fails the batch

Field	Type	Required	Description
results	GeocodeBatchResult[]	yes	One entry per query, `index`-tagged and in request order.

400Malformed body, or an empty queries array

401Missing or invalid API key

422More than 1,000 queries (urn:sn-gateway:problem:batch-too-large, body carries max_queries and queries)

429Quota or rate limit exceeded

501Geocoding not enabled (neither SN_GEOCODE_DIR nor SN_PHOTON_URL set)

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

Also under geocoding

GET /geocode GET /geocode/retrieve GET /geocode/reverse GET /geocode/suggest

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